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ABSTRACT 


This  thesis  describes  a  set  of  APL  programs  which  enable 
a  student  to  learn  A  Programming  Language  (A?L)  by  using  it. 
Th9  student  needs  to  know  only  how  to  log  on  to  the  computer 
and  enter  a  f9w  simple  commands  to  begin  the  coarse. 

The  basic  unit  of  the  TUTOR  workspace  is  the  text  vari¬ 
able  which  describes  the  use  of  one  of  seventy-five  built-in 
APL  functions.  This  description  is  accessible  by  a  H2LP 
function  without  going  through  an  entire  lesson.  Other 
functions  conduct  interactive  question-and-answer  drill.  a 
HERO  function  lists  the  units  for  student  selection  of  a 
lesson  or  information  on  a  symbol.  The  sruient  can  also  go 
through  a  sequence  of  lessons  in  a  oomputar-drivan  course. 

These  programs  were  written  on  and  for  the  IBM  3333 
installation  at  Naval  Postgraduate  School,  using  APL  version 
4.0  for  VM/cas  with  IBB  3278  terminals. 
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I.  BACKGROUND 


A  Programming  Languags  (APL)  is  an  interactive,  inter¬ 
pretive  computer  language  designed  by  Kenneth  S.  Iverson  at 
Harvard  ir.  1962.  Its  advantages  include  the  ease  of  manipu¬ 
lation  of  multi-dimensional  arrays  of  numbers,  the  lack  of 
rigorous  input/output  formatting,  and  the  use  of  unique 
symbols  to  represent  a  wide  variety  of  built-in  functions. 
Unlike  other  high-level  languages,  there  is  no  requirement 
to  write  and  compile  a  strictly  formatted  program  before 
execution.  APL  may  be  used  in  "desk  calculator"  mode,  where 
a  single  line  of  input  is  accepted  and  evaluated,  returning 
an  immediate  response.  While  it  may  take  quite  some  ■‘•ims 
for  the  user  to  master  APL  fully,  the  beginner  can  quickly 
jump  in  and  start  experimenting. 

The  APL  TUTOR  was  designed  to  enable  the  beginning  APL 
student  to  gain  some  familiarity  with  the  basic  concepts  of 
the  language  without  going  through  a  formal  course.  It 
consists  of  a  set  of  APL  programs  which  enable  the  student 
to  enter  simple  commands  and  receive  information,  questions, 
and  drill  about  the  symbols  and  functions  used  in  APL. 
Since  at  present  no  information  on  writing  functions  is 
included,  it  may  be  used  as  a  supplement  to  the  normal  mode 
of  teaching  at  nps. 

Currently  the  APL  student's  resources  at  NPS  consist  of 
the  instructor,  other  students,  and  texts  such  as  these 
listed  in  the  bibliography.  There  also  exists  a  copyrighted 
IBM  drill  function,  TEACH,  found  in  the  APLCOUBS  workspace 
in  the  public  library  of  most  APL  installations.  (At  NPS, 
it  can  be  accessed  by  entering  )  LOAD  1  APLCOURS  while  in  APL 
mode.)  This  function,  and  a  sub-function,  EASYDKILL, 
provide  simple  drill  questions  for  calculator  functions 
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selected  by  the  student.  This  workspace  does  not,  however, 
provide  any  information  concerning  the  correct  use  or  syntax 
of  any  functions. 

The  specific  audience  targeted  is  the  first  to  third 
quarter  NPS  students  in  the  Operations  Analysis  curriculum, 
who  are  currently  taught  APL  in  one-hour  weekly  labs  as  part 
of  three  probability  and  statistics  courses.  Jiany,  if  r.ot 
most,  of  these  students  arrive  at  NPS  from  six  weeks  to  six 
months  before  their  first  guarter.  It  would  be  tc  their 
advantage  to  get  a  'head  start*  on  learning  APL,  but  there 
is  no  separate  course  in  this  language  as  there  is  in 
PORTS  AN  or  PASCAL,  for  example. 

A  basic  requirement  for  the  TUTDR,  then,  is  that  it  be 
comprehensible  to  someone  who  has  never  seen  APL  before.  Ir. 
fact,  the  "desk  calculator"  functions  should  be  understand¬ 
able  to  someone  who  has  never  even  used  a  computer  before. 
This  means  that  some  of  the  beginning  lessons  may  seem  too 
simplistic  to  the  student  who  has  soma  programming  experi¬ 
ence.  However,  the  more  advanced  student  can  easily  skim 
through  this  primary  material  and  progress  to  the  more 
sophisticated  concepts.  Intermediate  mathematics  including 
concepts  of  linear  algebra  is  the  only  background  informa¬ 
tion  that  is  assumed. 
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ii.  using  apl  tutor 


The  APL  TUTOR  workspace  should  be  available  in  or.e  of 
the  public  libraries  at  NPS.  Instructions  for  loading  and 
copying  it  are  on  the  first  page  of  Appendix  A.  If  it  is 
not  available  in  the  public  libraries,  it  can  be  obtained 
from  Professor  R.  R.  Read  upon  request. 

The  APL  TUTOR  workspace  contains  sixteen  functions  which 
administer  the  course.  Their  interrelationship  is  shewn  in 
Figure  B.l.  In  this  diagram,  the  ovals  indicate  functions 
which  are  called  by  the  student,  while  rectangles  indicate 
functions  which  are  called  internally.  The  procedure  of 
each  function  is  outlined  in  Figures  B.4  through  3.21. 
Further  information  can  be  found  in  the  comment  lines  of 
each  program  in  Appendix  B,  part  B. 

The  actual  text  of  the  course  is  contained  in  APL  vari¬ 
ables  which  are  displayed  by  the  functions  show  and  run. 
The  text  of  each  variable  can  be  found  in  Appendix  B,  part 
C.  2.  Also  in  Appendix  B  (part  C.1)  are  several  global  vari¬ 
ables  which  are  used  in  various  programs.  Most  important  of 
these  is  MAT,  which  provides  information  on  each  text  vari¬ 
able,  such  as  the  symbol  it  pertains  to,  the  function  type 
(Monadic/Dyadic/Neither)  ,  the  type  of  arguments  it  takes 
(Numeric,  character  (K) ,  Either,  Boolean),  the  rank  of  the 
arguments  permitted  (Scalar,  Vector,  matrix(X),  Any),  and  a 
sequential  lesson  number.  The  other  major  global  variable 
is  CUES,  which  consists  of  a  number  of  questions  that  can  be 
called  upon  by  the  ASK  function. 

Before  commencing  the  APL  TUT3R  course,  the  student 
needs  to  have,  as  a  minimum,  the  instructions  given  on  the 
first  page  of  Appendix  A.  The  other  information  the  student 
will  need  is  displayed  1  y  the  TUTOR,  and  is  also  included  in 


Appendix  A,  which  should  be  given  to  all  students  who  will 
be  using  TUTOR.  The  variable  HDW  is  displayed  each  and 
every  time  the  workspace  TUTOR  is  loaded  by  the  student,  ana 
can  also  be  called  up  at  any  time  by  entering  HOW.  The 
other  variables  in  Appendix  A  are  displayed  by  the  START 
function.  Most  may  be  called  up  by  the  student  at  any  time, 
as  noted. 

Figure  B.1  shows  the  variety  of  ways  the  student  can 
access  and  use  the  information  in  TUTOR.  The  beginner 
enters  START  to  get  the  basic  background  information  needed 
to  complete  the  course.  START  instructs  the  student  to 
enter  LESSON  100  to  begin  the  course.  After  completing  this 
lesson,  the  student  merely  has  to  enter  LESSON  NEXT  to 
receive  the  instructional  units  in  the  order  indicated  in 
the  variable  MAT. 

The  student  who  is  enrolled  in  a  course  using  APL  may 
also  follow  the  instructor's  guidance  concerning  lessons  to 
taka.  The  student  enters  LESSON  NNN,  where  NNN  is  the 
lesson  number  assigned.  A  more  advanced  student  car.  explore 
or  review  earlier  lessons  by  entering  TEACH  and  then  the 
symbol  that  he/she  is  interested  in. 

The  more  advanced  student  may  also  be  interested  in  the 
HELP  function  which  displays  information  without  asking 
guesticns  or  providing  a  drill.  The  student  can  enter  HELP, 
followed  by  the  appropriate  symbol,  or  INFO  NNN,  where  NNN 
is  the  same  as  the  pertinent  lesson  number.  These  lessor, 
numbers  can  be  found  by  entering  MENU  and  browsing  the  list 
displayed.  MENU  also  repeats  the  instructions  for  using 
LESSON  and  INFO. 

Effort  has  been  made  to  ensure  that  the  programs  will 
not  terminate  abnormally  in  response  to  a  student  input 
error.  Every  input  is  checked  for  validity  before  it  is 
processed.  For  example,  see  the  function  DRILL,  page  59,  at 
lines  8  to  17.  However,  because  it  is  not  possible  to  check 


for  every  possible  input  or  combination  of  inputs,  there  may 
still  be  some  way  to  cause  an  error.  Instructions  to  the 
student  in  case  of  an  error  are  included  in  the  BASICS 
displayed  by  the  START  function.  The  student  should  have  5 
hard  copy  of  these  instructions,  as  well. 

Any  input  by  the  student  at  a  time  when  no  input  is 
called  for  will  cause  an  abnormal  termination.  This  is 
inherent  ir.  the  APL  interpreter  and  cannot  be  avoided  by  the 
programmer.  However,  all  the  student  needs  to  do  in  this 
case  is  restart  by  entering  one  of  the  elementary  commands 
(HELP,  TEACH,  LESSON,  etc.) 

A  sample  run  is  included  at  Appendix  C. 
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III.  EXTENDING  APL  TU^OR 


There  are  many  ways  in  which  the  APL  TUTOR  can  be 
expanded  to  improve  its  usefulness.  Lessons  could  be 
included  on  the  many  system  commands  and  variables  which  are 
used  in  APL.  Auxiliary  lessons  on  groups  of  functions,  s.g. 
logical  functions,  and  their  basin  concepts  could  provide 
useful  additional  information.  Lessons  could  be  add^d  to 
describe  programming  techniques,  and  amplifying  lessons  on 
applications  could  be  provided.  Probably  any  of  the  lessens 
could  benefit  from  additional  questions  to  be  induced  in 
the  ASK  function.  Also,  the  ASK  function  itself  could  be 
modified  to  permit  mere  complex  questions  and  answers. 

Another  type  of  improvement  from  the  pedagogical  point 
of  view  would  be  the  inclusion  of  facilities  for  measuring 
and  recording  students'  progress.  The  student  could  be 
tested  after  every  lesson  or  group  of  lessons  and  the  scores 
recorded  for  the  instructors  review.  Or,  the  course  cculi 
be  designed  to  automatically  review  the  student's  weak  areas 
and  retest  before  going  cn.  In  any  case,  it  might  be  bene¬ 
ficial  to  include  lessons  which  review  concepts  covered  by 
the  course  so  far. 

A  test  and  evaluation  of  the  TUTOR  would  be  extremely 
beneficial  in  comparing  it  to  the  current  teaching  methods. 
Students  could  be  tested  for  their  knowledge  of  APL  and 
those  who  had  used  the  TUTOR  compared  to  those  who  had  not. 
Furthermore,  different  versions  of  the  TUTOR  could  be  tested 
against  each  other.  Several  different  texts  could  be  used, 
or  versions  with  and  without  the  drill  functions. 

This  could  lead  to  a  still  more  sophisticated  modifica¬ 
tion  of  the  course,  in  combination  with  programmed  student 
testing.  After  an  initial  unit,  the  testing  could  be 


12 


designed  to  reveal  what  type  of  instruction,  e.g.  drill  or 
no  drill,  works  best  for  that  individual  student.  Or,  the 
student  could  simply  be  asked  his  or  her  preferences  ir. 
terms  of  teaching  techniques.  Then  the  course  would  auto¬ 
matically  tailor  later  lessons  to  the  individual. 

All  of  these  changes  require  someone  skilled  in  APL  to 
modify  the  current  programs.  These  programs  have  beer, 
heavily  documented  by  flow  charts  and  comment  lines 
(Appendix  B)  in  order  to  make  the  task  of  modification 
easier.  Also,  specific  instructions  for  certain  types  of 
modifications  are  included  in  the  variable  HOWMODS,  Appendix 
B,  part  D.  Any  advanced  student  can  personalize  a  copy  of 
TUTOR  with  the  help  of  these  tips.  For  more  substantial 
modifications  such  as  those  suggested  above,  the  point  of 
contact  for  the  public  version  of  TUTOR  at  MPS  is  Professor 
R.  R.  Read. 
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APPgNDIX  A 

USEB'S  GDIDE  TO  APL  TUTOR 


IF 

1. 

2. 

3. 


4. 

5. 

6. 

7. 

8. 

9. 


10. 


11. 


12. 

13. 

14. 


you  HAVE  NEVER  EVER  USED  THE  COMPUTER  BEFORE,  START  HERE: 

Go  to  the  Registration  and  Accounting  Office  inside 
Ingersoll  rm.  141.  Ask  for  a  user  number.  Ycu  will 
need  to  tell  them  the  password  you  want  to  use. 
while  you  are  there,  pick  up  a  copy  of  NPS  Technical 
Note  VS-01,  "User's  Guide  to  vm/cms  at  NPS." 

Follow  the  instructions  in  VM-01  for  ioggina  on  and 
formatting  your  disk.  If  your  keyboard  has  little  red 
symbols  on  it,  you  may  continue  with  step  6  below. 
Otherwise,  log  off  (see  VM-01)  and  continue  with  step  u 
when  you  are  ready. 

IF  YOU  HAVE  FORMATTED  YOUR  DISK,  START  HERE: 


Find  a  free  terminal  (in  Ingersoll  room  141  or  room  369) 
that  has  red  symbols  on  the  keyboard, 
log  on  and  enter  your  password; 

When  you  see  a  line  beginning  SMS...,  press  the  ENTER 

|^Oy  # 

When  you  see  a  line  beginning  R:  ...»  enter  the  letters 

A  Plw  • 

You"should  see  several  lines  appear  ending  with  the  line 
CLEAR  WS.  If  you  don't,  stop  nare  and  get  help! 

Now  look  at  the  bottom  center  of  your  screen,  below  the 
line.  If  you  see  the  letters  Apl,  go  or.  to  the  next 


the  front. 


ey 


. .  .  _  .  _ _  _  should  now  appear 

bottom  of  your  screen.  This  tells  the  terminal 


The  letters  APL 


at  the 

.  _  ..  .  _  _  _ _  to  use 

the  red  symbols  when  you  upshift.  To  use  the  red 
symbols  on  the  front  of  the  keys,  you  must  hold  down  the 
ALT  key  instead  of  the  SHIFT  key. 

IF  THIS  IS  THE  VERY  FIRST  TIMS  YOU  ARE  USING  APL  TUTOR, 
ENTER  ) LOAD  5  TUTOR.  (Remember  to  use  the  red  paren¬ 
thesis,  third  row,  far  right,  not  the  black  parenthesis 
in  the  too  row.)  OR  FOLLOW  THE  DIRECTIONS  GIVEN  BY  YOUR 
INSTRUCTOR.  If  you  have  used  TUTOR  before,  and  you 
followed  the  directions  in  steps  12  and  13  below,  just 
enter  )  LOAD  TUTOB. 

Now  just  follow  the  directions  which  appear  on  the 
screen.  If  no  directions  appear,  and  all  you  see  is  a 
line  which  says  SAVED...  and  possibly  a  line  which  says 
WSSIZE....  enter  HOW  to  see  the  directions.  To  be  sure 
that  the  directions  appear  every  time,  enter  START, 
follow  steps  12  and  13  when  you  finish  your  session. 

If  this  is  the  first  time  you  have  used  TUTOR,  ei 
) WSID  TUTOR. 

when  you  are  ready  to  quit  for  the  day,  enter  )SAVE. 

When  you  see  the  time,  date,  and  TUTOR,  enter  )OFF. 
This  will  log  you  off  the  computer  completely.  (For 
more  advanced  students:  )  OFF  HOLD  will  return  you  to 

CMS.) 


ana 
enter 
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HOW 


YOU  MAY  USE  THE  APL  TUTOR  IN  THREE  WAYS* 

(1)  enter;  help 

to  select  the  symbols  that  you  want  information  about, 

(2)  enter;  teach 

TO  SELECT  THE  SYMBOLS  THAT  YOU  WANT  INFORMATION  AND  DRILL  ON, 

(3)  enter;  menu 

TO  SEE  A  LIST  OF  SYMBOLS  AND  TOPICS, 

IF  YOU  HAVE  NEVER  USED  THE  APL  TUTOR  BEFORE,  ENTER;  START 

TO  SEE  THESE  INSTRUCTIONS  AGAIN  AT  AH Y  TIME,  ENTER ;  HOW 
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WELCOME  TO  THE  APL  TUTOR, 

THE  PURPOSE  OF  THIS  WORKSPACE  IS  TO  INTRODUCE  YOU  TO 

•A  PROGRAMMING  LANGUAGE 1  BY  DESCRIBING  THE  FUNCTIONS  OF  THE 
MANY  SPECIAL  APL  SYMBOLS,  AND  BY  OUTLINING  THE  PROCEDURES  FOR 
DESIGNING  YOUR  OWN  FUNCTIONS, 


BACKGROUND 

THE  APL  TUTOR  ASSUMES  YOU  HAVE  HAD  LINEAR  ALGEBRA  AMD  TRIGINOMETRY 
CALCULUS  IS  NOT  NECESSARY. 

IF  YOU  HAVE  NEVER  HAD  ANY  COMPUTER  PROGRAMMING  BEFORE,  DON'T  WORRY 
YOU  CAH  START  USING  APL  RIGHT  AWAY,  AS  A  SUPER-SDPHI ST  I CATED 
CALCULATOR  WITH  MANY  BUILT-IN  FUNCTIONS, 

IF  YOU  HAVE  STUDIED  OTHER  COMPUTER  PROGRAMMING  LANGUAGES,  RELAi!, 
APL  15  NOT  LIKE  ANY  OF  THE  OTHER  MAJOR  HIGH-LEVEL  LANGUAGES, 

YOU  CAH  FORGET  ABOUT  DATA  TYPES,  IHPUT/OUTPUT  FORMATTING,  AND 
MAHY  OF  THE  OTHER  TEDIOUS  DET AILS  OF  FORTRAN,  PASCAL,  ETC, 

AFTER  YOU  ARE  SUFFICIENTLY  FAMILIAR  WITH  THE  CALCULATOR  MODE 
OF  APL,  YOU  CAN  LEARN  TO  DEFINE  YOUR  OWN  FUNCTIONS  WITH  EASE, 
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BASICS 


HERE  IS  SOME  BASIC  INFORMATION  YOU  WILL  NEED  TO  KNOW  IN  ORDER  TO 
UNDERSTAND  THE  ARL  TUTOR  LESSONS, 

MONADIC  AND  DYADIC  FUNCTIONS 

YOU  ARE  ALREADY  FAMILIAR  WITH  SYMBOLS  WHICH  REPRESENT  ARITHMETIC 

FUNCTIONS,  SUCH  AS  +  OR  + ,  ARL  USES  THESE  SYMBOLS  AND  MANY  OTHERS 
TO  REPRESENT  A  VARIETY  OF  FUNCTIONS, 

MAHY  FUNCTIONS,  SUCH  AS  + ,  REQUIRE  TWO  ARGUMENTS,  THAT  IS,  TWO  INPUT 
NUMBERS,  IN  APL,  THESE  ARE  CALLED  DYADIC  FUNCTIONS,  AND  THE  SYMBOL 
IS  PLACED  BETWEEN  THE  ARGUMENTS}  FOR  EXAMPLE,  3+4, 

OTHER  FUNCTIONS,  SUCH  AS  LM  (NATURAL  LOG),  REQUIRE  ONLY  ONE  ARGUMENT, 
THESIS  MONADIC  FUNCTION  SYMBOLS  ARE  PLACED  TO  THE  LEFT  OF  THE  DATA 
WHICH  THEY  ARE  TO  OPERATE  ON,  FOR  EXAMPLE,  LN  3  IN  AFL  IS  #3, 

DATA  TYPES 

APL  DISTINGUISHES  ONLY  TWO  TYPES  OF  DATA*  NUMERIC  AND  CHARACTER, 

VERY  SIMPLY,  CHARACTER  DATA  ARE  ENCLOSED  IM  QUOTES  (')  WHEN  ENTERED, 
•2’  IS  CHARACTER  DATA}  2  IS  NUMERIC  DATA,  SOME  FUNCTIONS 
WILL  OPERATE  ON  BOTH  TYPES  OF  DATA,  SOME  ONLY  OH  NUMERIC, 

ARRAYS 

THE  GREATEST  STRENGTH  OF  APL  LIES  IN  ITS  ABILITY  TO  TAKE  AN  ENTIRE 
ARRAY  OF  NUMBERS  AS  A  SINGLE  ARGUMENT,  THUS  TWO  MATRIXES  CAN  BE 
ADDED  BY  ENTERING  SIMPLY  A+B,  WITH  NO  SUBSCRIPTS,  LOOPS,  ETC, 

THIS  MAKES  IT  IMPORTANT  TO  KNOW  THE  RANJt  (THE  HUMBER  OF  DIMENSIONS) 

OF  DATA  IN  USE,  A  SINGLE  NUMBER  IS  NORMALLY  A  SCALAR  (RANK  0). 

A  SERIES  OF  NUMBERS  IS  A  VECTOR,  A  ONE-DIMENSIONAL  ARRAY  (RANK  1), 
NUMBERS  CAN  ALSO  BE  ARRANGED  IN  ROWS  AND  COLUMNS,  TO  MAKE  A  MATRIX 
(RANK  2).  MATRIXES  CAN  BE  •STACKED1  TO  MAKE  UP  THE  P  AgES  OF  A 
THREE-DIMENSIONAL  ARRAY,  OFTEN  CALLED  A  BOOK  (RANK  3),  IN  FACT, 
THERE  IS  HO  LIMIT  TO  THE  NUMBER  OF  DIMENSIONS  IN  AN  APL  ARRAY, 

THE  WSUSZtt  0F  THE  DIMENSIONS  IS  ALSO  EFFECTIVELY  UNLIMITED,  LENGTH 
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REFERS  TO  THE  HUMBER  OF  ELEMENTS  IN  A  DIMENSION,  FOR  EXAMPLE, 

THE  NUMBER  OF  ROMS,  LENGTH  MAY  EVEN  BE  0. 

IN  THIS  TUTORIAL,  A  SCALAR  MAY  BE  REFERRED  TO  AS  S,  L,  OR  R, 

A  VECTOR  MAY  BE  CALLED  V,  VJ,  OR  V2 ,  WHILE  A  MATRIX  IS  M,  Ml,  OR  M2, 
AH  ARRAY,  WHICH  MAY  BE  A  VECTOR,  A  MATRIX,  OR  AM  ARRAY  OF  ANY  HIGHER 
DIMENSION,  WILL  BE  LABELLED  A,  Al,  OR  A2, 

EXAMPLES 

WHEN  EXAMPLES  ARE  GIVEN  IN  THE  TEXT  OF  A  FUNCTION  DESCRIPTION,  THE 

SYMBOL  =>  IS  USED  BETWEEN  THE  EXAMPLE  INPUT  AND  THE  EXAMPLE  OUTPUT. 

for  example;  2+5  =>  7 

THIS  SYMBOL  CAN  BE  READ  AS  'PRODUCES'  OR:  'RETURNS', 

ERRORS 

YOU  SHOULD  HOT  RECEIVE  ANY  ERROR  MESSAGES  WHILE  USING  APL  TUTOR, 
HOWEVER,  YOU  MAY  SEE  A  PHRASE  LIKE  'VALUE  ERROR'  (WITHOUT  QUOTE 
MARKS)  WHEN  YOU  ARE  EXPECTING  A  NORMAL  RESPONSE, 

OR  IF  YOU  ACCIDENTALLY  HIT  THE  ENTER  KEY  WHEN  THE  COMPUTER  IS  NOT 
EXPECTING  AN  INPUT,  THE  FUNCTION  MAY  END  ABRUPTLY,  LIKE  THIS) 

MENU  C63 

IF  EITHER  OF  THESE  THINGS  HAPPEN,  BE  SURE  TO  ENTER*  4  (UPSHIFT  4 ) 
THEN  RESTART  WITH  ANY  COMMAND, 

HALTING  A  LESSON 

YOU  MAY  STOP  ANY  LESSON  AT  ANY  POINT  WHERE  A  QUESTION  IS  ASKED 
BY  ENTERING*  STOP 

TO  SEE  THIS  INFORMATION  AGAIN  AT  ANY  TIME,  ENTER;  BASICS 
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HONTEACH 


YOU  MAY  START  A  LESSON  IN  THREE  WAYS* 

(1)  ENTER J  LESSON  NEXTLESSON 

TO  START  THE  LESSON  F OLLW INC  THE  LAST  OHE  YOU  COMPLETED , 

(2)  ENTER }  LESSON  NNN  (WHERE  HHN  IS  A  3-DIGIT  NUMBER) 

TO  START  LESSON  NUMBER  NNN, 

TO  SEE  A  LIST  OF  LESSON  NUMBERS,  ENTER*  MENU 

(3)  ENTER }  TEACH 

TO  SELECT  THE  SYMBOL  THAT  YOU  WANT  A  LESSON  ON, 

TO  SEE  THIS  INFORMATION  AGAIN  AT  ANY  TIME,  ENTER*  HOWTEACH 
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ApPENDII  B 
PBOGRA HMER' S  GO IDE 


A.  FLOW  CHARTS 

Figure  B.1  shows  the  relationship  of  the  various  func¬ 
tions  within  the  IOTOR  workspace.  The  first  function  called 
by  the  new  student  should  be  START.  After  that,  the  student 
will  usually  commence  a  session  by  calling  MENU,  TEACH, 
HELP,  LESSON,  or  INFO.  These  functions  in  turn  call  the 
other  functions  of  TUTOR  as  indicated  by  the  arrows.  The 
procedure  of  these  functions  is  nutlinea  in  figures  3.2 
through  B.21. 

In  APL,  there  is  no  difference  in  the  programming  of 
main  routines,  subroutines,  and  functions;  all  are  referred 
to  as  functions.  However,  when  one  function  calls  another 
function,  the  calling  function  is  suspended  until  the  called 
function  is  completed.  Then  the  calling  function  resumes 
operation,  possibly  using  the  result  of  the  called  function. 
Therefore,  "return  to  the  calling  function,  if  any"  is 
implied  at  the  end  of  9very  program  but  is  not  explicit. 
END,  implying  return,  is  shown  in  the  diagrams  only  in  those 
functions  which  are  normally  called  by  another  function. 

It  should  be  noted  that  "room  for  expansion"  has  been 
provided  in  the  SHOW,  RUNDRILL,  DRILL,  and  TEST  functions. 
RUNDRILL  and  DRILL  have  the  capability  to  display  drill 
questions  with  matrix  arguments.  This  capacity  is  not 
currently  being  used  because  the  irswer  must  be  input  in 
vector  form.  It  was  felt  that  this  might  confuse  the 
student.  However,  further  development  and  experimentation 
eight  find  uses  for  this  type  of  question,  so  the  matrix 
fora  has  been  left  available.  TEST  and  SHOW  have  calling 
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lines  for  the  matrix  form  commented  out.  There  are  else 
comment  lines  in  SHOW  to  indicate  where  matrix  and  higher- 
level  arrays  questions  would  go  if  they  are  added  in  the 
future.  See  the  section  on  making  modifications  for  more 
information. 

The  four  functions  at  the  bottom  of  figure  B.1  are  not 
part  of  the  TUTOR  function  hierarchy.  NEXTLESSON  is  used  to 
provide  a  lesson  number  when  the  student  calls  for  LESSON 
NEXT  LESSON.  ORDERMAT  is  provided  for  the  benefit  of  the 
programmer  to  rearrange  the  sequence  of  lessons  in  bh^ 

course.  TEST  is  also  provided  for  the  programmer  (or 

student)  who  wishes  to  run  only  the  drill  section  of  a 

lesson.  SQUEEZE  is  a  utility  called  by  several  functions  to 

delete  blanks  in  a  string  of  characters. 
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Figure  B.  2 


Figure  B. 
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Procedure  of  STABT  Punction. 


3  procedure  o£  SEHO  Function. 
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HELP 


Figure  B.4  Procedure  of  HELP  Puuctioa. 
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Figure  B.5  procedure  of  IMFO  Function 


Figure  B. 6  Procedure  of  BOM  Function. 
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Figaro  B. 8  Procoduro  of  LBSSOft  Function. 
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Figure  B.9  Procedure  of  SHOB  Function— 1. 
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rigor*  B.10  Proc*dur*  o£  SHO»  Fuaction--2 


Figure  B.11  Procedure  of  SHOW  Function--3. 
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Figura  B. 12  Procadure  of  iSK  Function 


Figure 


•13  Procedar*  of  SOHiSK  Function. 
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Set  flag 
♦proceecr 

W 

Set  flag 
•repeat* 

Figure  B.  14  Procedure  of  SCOBS  Function. 
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Figure  B.  16  Procedure  o£  DRILL  Function. 
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Figure  B.18  Procedure  of  TRI  Function — 1 


Figure  B.19  Procedure  of  T8I  Function — 2. 
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Figure  B.21  Procedure  of  SQUEEZE,  NEXT LESSON,  and  OBDEBMBT  Fns. 

4  1 
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B.  FOHCTIONS 

The  following  section  contains  the  APL  functions  which 
operate  the  TOTOS  course.  The  consent  lines,  which  begin 
with  a  symbol,  indicate  the  procedure  in  general,  but  do 
not  describe  the  specific  programming  techniques  used. 
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7  MEHU 1 222 

C 13  A  REQUIRES  GLOBAL  VARIABLE  MAT 

C23  [JF 1  INFORMATION  IS  AVAILABLE  OH  THE  FOLLOWING  SYMBOLS/TOF ICS •  1 

C3]  n  format  and  display  menu 
C43  sszKSfi)  ,0,  (I7f  1)  »0 

E53  ( (r((P«ftT)cn)^3),72)f zzz\matcjlescol,symcol,fmamecol] 

C63  Qf'to  see  menu  again,  enter;  menu  1 ,cr, tor  ihformat 

I  OH  ABOUT  FUNCTION,  ENTER.;  INFO  HUH  (WHERE  HHN  IS  MENU  NUMBER) 
' ,CR,'TO  GO  THROUGH  TUTORIAL  LESSON,  ENTER}  LESSON  CNN' 
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7  HELP ; symbol; ROWS }NNN}R 
Cl]  H  CALLS  QUEUE,  MENU,  SQUEEZE 

C2]  Q<- ' ENTER  THE  SYMBOL(S)  YOU  WOULD  LIKE  INFORMATION  ABOUT  >  1 

C33  Q*-'  OR,,, FOR  MENU  SELECTION,  ENTER;  MENU' 

[43  ft  DELETE  BLANKS  IN  RESPONSE 

C53  symbou-squeeze  symbol*.q 

C6]  ft  IP  RESPONSE  IS  'MENU',  GO  TO  1  OTHER •}  ELSE  GO  ON 
[73  -+OTHER x  \  (4s  +  /  +  /SYMBOL«  ,  =  'MENU  1  ) 

C83  ft  PINO  INDEXES  OF  ROWS  THAT  CONTAIN  THE  RESPONSE  IN  SYMBOL  COLUMN 
[93  ROWS«-(MAT[;SYMCOL  3£  SYMBOL  )/  \  (  f  MAT  )  [  1  3 

CIO]  ft  IP  HO  ROWS  CONTAIN  RESPONSE,  GO  TO  • OOFS3 • }  ELSE  GO  ON 
C 1 1 3  -»oops3x  io=fROws 

c 12]  ft  START  LOOP  COUNTER  AND  SET  LESSON  NR  TO  0 
C 13]  NNH«.R«-0 

c 14]  ft  INCREMENT  COUNTER 
CIS]  NEWROW  ;  R«-R+  1 

CIA]  0«-cr 

c 1 73  (I  CALL  RUN  TO  DISPLAY  HELP  FUNCTION  FOR  ROW  CORRESPONDING  TO  COUMTE 
R 

[18]  RUN  ROWS[R 3 

Cl  9  ]  (I  IP  MORE  ROWS  REMAIN,  RETURN  TO  NEWROW}  ELSE  GO  ON 
[20]  -»NEWROWXlR<fROWS 

C213  ft  PRINT  FUNCTION  ENDING  MSG  AND  EXIT 
C22]  Of  FOR  MORE  HELP,  ENTER;  HELP' 

C  233  40 

C  24  3  ft  SYMBOL  NOT  FOUND}  PRINT  ERROR  MSG  AND  EXIT 

C25]  OOPS350f SORRY,  INFORMATION  ABOUT  THIS  SYMBOL  IS  NOT  AVAILABLE  AT  T 
HIS  TIME, 1 , Cg, ' FOR  HELP  WITH  ANOTHER  SYMBOL,  ENTER*  HELP,' 

C26]  40 

C273  ft  RESPONSE  IS  'MENU'}  EXECUTE  RESPONSE  AND  EXIT 
C28]  OTHER ; ^SYMBOL 
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7  INFO  NNN; ROW 

C 1 1  n  CALLS  run;  requires  global  variable  mat 

£23  A  IF  NNN  IS  NOT  A  SCALAR,  GO  TO  'OORSi;  ELSE  go  oh 

[33  ->OOPSlX  \(  f’fHNN)  >0 

[43  A  FIND  INDEXES  OF  ROW 

[53  ROW«.((tfMATC;LESCOL])=WNN)/,  MAT)  C13 

£63  A  N0  SOWS  CONTAIN  RESPONSE,  GO  TO  ' OOPS3 1 J  ELSE  GO  ON 

£73  -*oops3xi0=P*c« 

[83  A  Ru«  help  FUNCTION 
[93  RUN  ROW 

E103  A  display  ending  message 

£113  flf*CR,  'FOR  MORE  INFORMATION,  ENTER  {  INFO  NNN  • 

[123  ->0 

C133  A  VECTOR  ARGUMENT;  PRINT  ERROR  MSG  AND  EXIT 

C 1 4 3  OOPSl ‘ INFO  MUST  be  followed  by  a  SINGLE  PARAMETER,  '  ,CR,  ' TO  PESTS 
RT,  enter;  INFO  NNN  (WHERE  NNN  IS  A  THREE-DIGIT  NUMBER)' 

C 153  -»0 

C163  A  INFO  NOT  found;  PRINT  ERROR  M5G  AND  EXIT 

[173  OOPS3*Qf 'SORRY,  INFORMATION  ABOUT  THIS  SYMBOL  IS  HOT  AVAILABLE  AT  T 
HIS  TIME, ' ,CR, ' FOR  HELP  WITH  ANOTHER  SYMBOL,  ENTER;  HELP,' 
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?  run  row; make; rank ; fname ; u 

Cl]  ft  CALLED  BY  HELP ,  INFO,  TRY}  CALLS  SQUEEZE 
[23  A  REQUIRES  GLOBAL  VARIABLE  MAT 

C3]  ftASSIGN  THE  NAME  OF  THE  help  VARIABLE  TO  THE  VARIABLE  'HAKE' 

[4]  namef,mat[row;mamecol] 

C5]  ft  Ta  Ha  IP  THE  HELP  VARIABLE  'NAME'  DOES  WOT  EXIST;  ELSE  GO  ON 

C63  -*hax\0=Qhc  name 

[72  ft  DISPLAY'  THE  GENERAL  DESCRIPTION  PORTION  OF  THE  HELP  VARIABLE 

C83  DHO  l)*((tNAME)c;i3=' , 1  )/!HAme 

[9]  ft  DISPLAY  SCALAR  PORTION  OF  HELP  VARIABLE 

CIO]  QKO  lHUiMAMEJCms'o'J/tWAME 

Cll]  ft  IP  HO  MORE  INFO,  EXIT}  ELSE  GO  ON 

C  123  -*0X|-l€  <iHAME)C;i3t  1  Vft*1 

C133  ft  as*  IP  MORE  detailed  info  desired 

E 1 43  Qy-cr  t  ' more? 1 

C 1 5 3  ft  ip  response  is  hull,  exit;  else  go  on 

C1&3  -»0x»0=fUpfl 

C173  4Qxi*'Y's(,U)C1] 

C183  «  display  vector  portion  of  HELP  VARIABLE 

c 1 9 3  a«Ko  m(<t«aME)c;n=' v' >/tMAME 

C203  ft  DISPLAY  MATRIX  PORTION  OF  HELP  VARIABLE 

C213  DKO  m<(tNAME)C;i3='n')/lMAME 

C223  ft  display  all  arrays  portion  of  help  variable 

C233  DKO  l)4((tNAME)C)l]s,*,)/tHAME 

C243  +0 

C253  ft  ass I gn  full  name  of  symbol  to  variable  'fname*;  print  error  msg 
[263  ma;fnamehsqueeze,mat[row;fnamecol] 

C273  □«-£R» 'SORRY,  INFORMATION  ABOUT  'jPHAME,'  is  hot  available  at  this 

time,  1 

7 


47 


w 


7  TEACH; SYMBOL; ROWS; MNH JR 
[13  A  CALLS  SCHEDULE,  MENU,  SQUEEZE 

[23  Q«-  *  ENTER  THE  SYMBOL(S)  YOU  WOULD  LIKE  INFORMATION  ABOUT,' 

[33  Qf  Oft  FOR  MENU  SELECTION,  ENTER •  MENU' 

[4  ]  R  DELETE  BLANKS  IN  RESPONSE 
[53  SYMBOL4-SOUEEZE  SYMBDL(.Q 

C63  ft  IF  RESPONSE  IS  'MENU1,  GO  TO  'OTHER1;  ELSE  GO  ON 
[7]  4 OTHER  X l ( 4  =  +  /  +  /SYMBOL» ,  =  1  MENU  1  ) 

C83  ft  FIND  INDEXES  OF  ROWS  THAT  CONTAIN  THE  RESPONSE  IN  SYMBOL  COLUMN 
[93  RQWS<-  (  MAT[  ;  SYMCOL3  l  SYMBOL  )  /  \  (  f'MAT  )  [  [  ] 

[103  ft  IF  NO  ROWS  CONTAIN  RESPONSE,  GO  TO  'OOPS3';  ELSE  GO  ON 
[113  400PS3no=pftows 

[123  ft  INITIALIZE  loop  counter  and  set  LESSON  NR  TO  0 

[133  nnn«.r>o 

[143  n  increment  counter 

[153  NEWROW  5  R<-ft+  i 

[163  CM-SS 

[173  ft  CALL  SHOW  TO  DISPLAY  TEACH  FUNCTION  FOR  ROW  INDEXED  BY  COUNTER 
[183  SHOW  ft OWS [ r  3 

[193  ft  IF  ROWS  REMAIN,  RETURN  TO  NEWROW;  ELSE  GO  ON 
[203  4MEWROWnR<  PROWS 

[213  ft  DISPLAY  END  OF  SCHEDULE  MSG  AND  EXIT 

[223  QpCR, 'THIS  IS  THE  END  OF  SCHEDULED  LESSONS CR ,' TO  SELECT  MORE  LE 
S50NS,  ENTER;  TEACH* 

[233  -*0 

[243  ft  SYMBOL  NOT  FOUND;  PRINT  ERROR  MSG  AND  EXIT 

[253  OOP53*Qf 'SORRY,  INFORMATION  ABOUT  THIS  SYMBOL  IS  NOT  AVAILABLE  AT  T 
HIS  TIME, ' ,CR, ' FOR  LESSONS  ON  ANOTHER  SYMBOL,  ENTER*  TEACH' 

[263  ->0 

[273  ft  RESPONSE  IS  'MENU*;  EXECUTE  RESPONSE  AMD  EXIT 
[283  OTHER ; ^SYMBOL 
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7  LESSON  NHHJPOW 
C 1 3  ft  CALLS  SHOW 

[23  ft  Ip  HHH  IS  NOT  A  SCALAR,  GO  TO  ' OOPSi;  ELSE  GO  OH 
[33  400PSi<\ (t fMNN) >0 

[43  f,  SELECT  ROW  FOR  LESSON  HUMBER  HHH 
C53  ROWp  (  (l>  MAT[  j  LESCQL  3  )  =  H,‘  'W  )  /  ;  (  f  MAT  )  [  1 3 

[63  ft  *F  MO  ROWS  CONTAIN  RESPONSE,  GO  TO  ‘ OOPST ' ;  ELSE  GO  ON 
[73  400PS3X io=f pow 

C83  ft  CALL  SHOW  TO  DISPLAY  TEACH  FUNCTION  FOR  ROWS  SELECTED 
[93  SHOW  ROW 

CIO]  ft  DISPLAY  ENDING  MESSAGE  AND  EXIT 

C113  Df'TO  START  ANOTHER  LESSON,  ENTER*  LESSON  HHH 1 

C123  -*0 

C133  ft  VECTOR  ARGUMENT*,  print  ERROR  MSG  AND  EXIT 

[143  00P51 ;□«.  1  LESSON  MUST  DE  FOLLOWED  El  A  SINGlS  PARAMETER,  * ,££, 'TO  RES 
TART,  ENTER;  LESSON  NNN  (WHERE  HHH  IS  A  THREE-DIGIT  NUMBER) 

I 

C153  *0 

C163  ft  lesson  hot  found;  print  error  msg  and  exit 

[173  OOPS3*  Dv  '  SORRY  ,  INFORMATION  ABOUT  this  symbol  is  not  available  at  ■*• 
HIS  TIME, 1 ,CR, ‘FOR  HELP  WITH  ANOTHER  SYMBOL,  ENTER*  HELP,' 
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9  SHOW  ROWfNAME j  G;  RANK  J  FNAME  }  T  J  RT  ;  UIT  ;  OV  ;  AV  ;  TY  RE  ;  ARG  }  SS  ;  F  ;  :  1  « 


Cl] 

A  CALLED  BY  SCHEDULE,  LES30N|  CALLS  ASK,  RUUDS  ILL, 

TR 

!',  SQUEEZE 

C  2  ] 

A  REQUIRES  GLOBAL  VARIABLE  MAT 

C33 

a  SET  VARIABLES  CORRESPOND IMG  TO  ROW 

C43 

NAME«-,MAT[ROWiHAMECOL] 

C53 

FNAME  (-SQUEEZE , M AT [ ROW ; FNAME COL } 

C63 

5YMfMAT[R.0W;STMC0L] 

C73 

R  AN  Kf  MAT  [ROW;  SV'/ACOL  ] 

C83 

type  (-mat  crow ; mdcol] 

C93 

arg«-mat[row;hkcol] 

C103 

a  GO  TO  MIA'  IF  HELP  VARIABLE  DOES  MO  T  EXIST ;  ELSE 

GO 

ON 

C 1 1 3 

4HAH(0  =  QMC  NAME) 

C123 

A  INITIALIZE  TOTAL  QUESTION,  WRONG  ANSWER  COUNTERS 

C 133 

RTt-WT^O 

C 1 4  3 

C 153 

1>\0 

C163 

A  DISPLAY  GENERAL  PORTION  OF  MELR  VARIABLE 

C173 

QMO  m<<tNAME)c;i3=' .  '  ) / 1 N A M E 

C183 

A  GENERAL  QUESTIONS 

C193 

OVRlf (5X\TYPE='D' ),6 

C203 

AVr( rl  +  TYPE= '  I"  ) , SQUEEZE  RANK 

C213 

QV  ASK  AV 

C223 

A  CHECK  HUMBER  OF  RIGHT  ANSWERS 

C233 

WT  SUMASK  RT 

C243 

A  IF  FLAG  INDICATES  'STOP'  RESPONSE,  GO  TO  HALT}  ELSE 

GO  ON 

C253 

C263 

•*haltxy=2 

C273 

a  DISPLAY  SCALAR  PORTION  OF  HELP  VARIABLE 

C283 

DM0  l)M(iH«ME)c;i]='.' j/jName 

C  29  3 

A  SCALAR  QUESTIONS 

C303 

-»SDxiTrP£='M> 

C313 

avf2 

C323 

AV<.'HY'd  +  SYMt  '+xri  =  *V*AA'3 
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C 33 3  av  ask  av 

c  3  4  3  ft  IF  FLAG  INDI CATES  'STOP'  RESPONSE,  GO  TO  HALT;  ELSE  GO  OH 
[353  4HALTxY=2 
c  36  3  ft  SCALAR  DRILL 

C  37  3  SDj4Vxx>.SYM£S5<.1+-X-rL:  l-U«i  =  >  )^VAV4,  f*' 

[383  -»vx  i  (  (Sim£  '+*/>,•  )attre='K'  )V(Stm£ • » ■ >  a  t  y  p  e =  >  d  ■ 
c  39  3  1  RUHDR ILL  1 

c  4  o  3  ft  IF  FLAG  INDICATES  ‘STOP1  RESPONSE,  GO  TO  HALT;  ELSE  GO  OH 
[413  4HALTXT=2 

[423  ft - - 

[43]  ft  display  vector  portion  of  HELP  VARIABLE 

[443  VIOKO  1  )  4  (  (  jHAME  ) [ » 1 ]s 1 V  *  )  /^NAME 
C453  ft  ASK  VECTOR  OUESTIOMS 
[463  4VDx)TYPE='MI 
[473  avt-3 

[483  avh'FT'Ci+syMjSS,  1  Kt  1  3 

[49]  av  ask  av 

[503  ft  iF  flag  indicates  ’stop'  response,  go  to  halt;  else  go  ok 
[513  4Haltxy=2 
[523  ft  VECTOR  DRILL 

[533  VDJ  4‘Xx  l  (*STHjSS,  ,t6t/\/\44<J9l  )V(  (S1M£  ■  ,+*  •  )  aTYPEs  1  M  1  )  v(S'X£  '  , )  A 
TYPE= 1 D 1 

[543  4VSX»(SYM£ < , ■ ) 

[553  1  RUND rill  2 

[563  ft  IF  FLAG  INDICATES  ’STOP1  RESPONSE,  GO  TO  HALT;  ELSE  GO  ON 
[573  4HALT X  Y r 2 

[583  VSJ4VVX\(SYM£ 'lift*'  )attfe='m' 

[593  4Xx\ (sym£ • pt4<*e' >vtype=-m' 

[603  2  PVNDRILL  1 

C613  ft  IF  flag  IMDICATES  'STOP'  RESPONSE,  GO  TO  HALT;  ELSE  GO  ON 
[623  4HALTXr*2 
[633  vv*4Xx\SYM£  • ,  • 

[643  2  aundrill  2 

[653  ft  IF  FLAG  INDICATES  'STOP'  RESPONSE,  GO  TO  HALT;  ELSE  GO  OH 
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[663  ->HALTxr=2 

[673  a - 

[683  A  DISPLAY  MATRIX  PORTION  OF  HELP  VARIABLE 
[693  XJOHO  l)4-((1HAME)[;i3=«n' 

[703  A  ASK  MATRIX  QUESTIONS 
[713  -»ax*type=,m‘ 

[723  ovl4 

[733  AVf 'FT' [ [  +  5YM  j *+-XT*«:n i=t<li>vvA*‘ 3 
[74]  QV  ASK  AV 

[753  A  1F  FLAG  INDICATES  ‘STOP1  RESPONSE,  GO  TO  HALT;  ELSE  GO  ON 

[763  -*haltxy=2 

[773  A  MATRIX  DRILL 
[783  md;  rType  rundrill  3 

[793  A  1F  FLAG  INDICATES  'STOP'  RESPONSE,  GO  TO  halt;  ELSE  go  on 
[803  -+HAL  T  X  T  =  2 

[813  a - - - 

C823  A  DISPLAY  all  arrays  PORTION  of  HELP  VARIABLE 

[833  »!DH0  1)t((iHAme)[;i]='*' )/tNAME 

[843  A  flSK  fi*-L  ARRAYS  QUESTIONS 

[353  ov«-8j9xup«-+/<1  2)x»AR6£ ‘KE1 

[863  AV*.(  '  NY  '  [1  +  xF])  ,  SQUEEZE  '  LR3'[1+F] 

[37]  QV  ASK  AV 

[883  A  Ip  FLAG  INDICATES  'STOP'  RESPONSE,  GO  TO  HALT;  ELSE  GO  ON 

[893  4HALTxY=2 

C903  a— - - - - 

C913  A  SUMMARIZE  STUDENT  PERFORMANCE 
[923  SUM  J  WT  SUMA5K  RT 

[933  A  IF  FLAG  INDICATES  'STOP'  RESPONSE,  GO  TO  HALT;  ELSE  GO  OH 
[94]  ->HALTXY  =  2 

[953  a . . — - - 

[963  A  CALL  TRY  FOR  SELECTED  SYMBOLS 

[97]  EXP;-*EHDx\»(SYM£  '+-1*'  )ATYPE='D' 

[98]  TRY  SYM 

[993  A  IF  FLAG  INDICATES  'STOP'  RESPONSE,  GO  TO  HALT;  ELSE  GO  ON 
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[  1003  4HftLTx'I'  =  2 

cion  « - - - - - - 

C 1 02 3  «  lesson  complete;  if  mnh=o  (teach),  exit;  else  go  oh 

[1033  ENDJ 40 x IMMNsO 

C1043  fl  NNN  jt()  (LESSON);  SET  LASTLESSON  TO  THIS  LESSON  MR 

C1053  outjlastlesson«.nnm 
[1063  0  DISPLAY  MSG  AND  EXIT 

C1073  [JpCRj'THIS  IS  THE  END  OF  YOUR  LESSON,' 

C10U3  Qf  1  FOR  THE  NEXT  LESSON  IN  SEQUENCE,  ENTER.;  LESSON  HEXTLE  5S0M  1 

C1093  40 

C1103  R  HELP  VAR  NOT  AVAILABLE;  DISPLAY  ERROR  MSG  AND  EXIT 
C1113  HA  J CR  ,  1  SORRY ,  INFORMATION  ABOUT  ‘  , FNAME ,  1  IS  NOT  AVAILABLE  AT  THI 
TIME , ' 

[1123  40 

C1133  HALTJCR,  1  THIS  LESSON  HAS  BEEN  HALTED,' 

V 
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7  OUE  5  ASK  AWSJRjWJi;  AfLJARfRKJQ 
C13  ft  CALLED  BY  SHOW}  CALLS  SCORE 

[23  ft  RE8UIP.es  non-local  v  a  f:  tables  rt,wt,y,  global  cues 
[33  ft  ASSIGN  the  NUMBER:  OF  QUESTIONS  TO  *  F:  ' 

[4]  R<-f,QUES 

[53  ft  ASSIGNS  TOTAL  NUMBER  OF  QUESTIONS  TO  1 R  T 1 
[63  RTpRT+R 

[73  ft  IP  hr.  OF  QUESTIONS  ?  NR  OF  ANSWERS,  GO  TO  'OOFS';  ELSE  go  on 
[33  -*00PSx\F*f  ,ans 

[9]  INITIALIZE  COUNTER,  CHARACTER:  VARS 

[103  If0 

[113  ft  START  LOOP;  INCREMENT  COUNTER ;  I  (VITALIZE  WRONG  ANSWER  COUNT 
[123  ST  ART  J  I  f  I  4*  1 

[133  WRO 

[143  ft  ASSIGN  QUESTION  AND  ANSWER  PARAMETERS  FOR  ASK  FUNCTION 

[153  A p ( , ANS ) [ I  3 

[U3  apCR,tCues[(,QUES)[i];] 

[173  ft  CALL  'SCORE'  TO  EVALUATE  THE  QUESTION 
[183  GUERT  *  A  SCORE  Q 

[193  ft  IF  FLAG  INDICATES  'REPEAT',  RETURN  TO  SAME  QUESTION*, 

[203  ft  IF  FLAG  INI'ICATES  'STOP'  RESPONSE,  E  X  IT;  ELSE  GO  ON 
[213  4 (QUERY ,0) C  T  3 

[223  ft  IF  QUESTIONS  REMAIN,  RETURN  TO  'START1;  ELSE  EXIT 
[233  ->5T ART x  (  I  <  R 

[243  ->0 

[253  ft  F°r  debugging;  arguments  not  same  length;  print  error  msg  and 

T 

[263  OOPSJDP' ftQUES  /  fAHS' 
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C13  ft  CALLED  BY  ASK 

[23  ft  REQUIRES  NON-LOCAL  VARIABLES  T,W,WT 
[3]  fl  DISPLAY  TENT  OF  QUESTION 
[41  □<-* 

[51  ft  ASSIGN  RESPONSE  TO  •INPUT1  AFTER  DELETING  BLANKS 
C6]  INPUTS  SQUEEZE  INPUTp|3 

C71  ft  1F  RESPONSE  IS  NULL,  ADD  1  WRONG  ANS  AND  GO  TO  1  LAST  1  ;  ELSE  GG  Oil 
[33  WT pWT  -pQ-f  INPUT 

[93  ->LASTU0  =  P  INPUT 

c 1 o  3  ft  *F  RESPONSE  IS  'STOP1,  GO  TO  'OUT1)  ELSE  GO  ON 
[113  40UT](l4s  +  /+/II)FUTc  ,  =  •  STOP  1 

[123  ft  IF  RESPONSE  j.  RIGHT  ANSWER,  GO  TO  'WRONG',*  ELSE  GO  ON 
[133  NEXT  { -pWROHGx  \  (  ,  INPUT  )C13*A 
[i43  A  DISPLAY  MSG 
[153  Op • right • 

[163  ft  SET  FLAG  TO  HULL)  EXIT 

[173 

[183  ft  INCREMENT  WRONG  ANSWER  COUNTERS 
[193  WRONG JWpW+l 
[203  WTpWT+1 

[213  ft  T°  LAST  IF  THREE  WRONG  AHSWERS  TO  THIS  QUESTION)  ELSE  GO  ON 

[223  -+L ast x  i  w >,3 

C233  ft  display  MSG 

[243  Qp1 SORRY,  PLEASE  TRY  AGAIN1 

[253  ft  set  flag  to  indicate  repeat  question;  exit 

C263  -»0»T<-1 

[273  n  hO 

[283  ft  three  wrong  answers;  display  msg 

[293  LAST • Qp1 SORRY,  the  correct  ANSWER  IS  1 , A 

[303  ft  SET  FLAG  TO  INDICATE  GO  TO  NEXT  QUESTION)  EXIT 

C313  T0»iF>0 

[323  ft  SET  FLAG  TO  INDICATE  'STOP1  RESPOHSE 

[331  OUTJYP2 

V 
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V  WT  SUM AS  K  R 

Cl]  n  CALLED  BY  SHOW  AFTER  ALL  'ASK'  CALLS 

C2]  ft  IF  FEWER  WRONG  RESPONSES  THAN  QUESTIONS,  EXIT  ;  ELSE  S' 
[33  40X\WT<.P. 

C4]  ft  WRONG  RESPONSES  >  QUESTIONS}  DISPLAY  MESSAGE  AND  EXIT 
C53  Qp'YOU  ENTERED  ‘,<*WT),'  WRONG  ANSWERS  OUT  OF  ‘ , ( rR ) , ' 

C63  Dp ‘tp  you  want  to  retake  this  lesson,  enter*  lesson 

LESCOL] 

C73  1>2 

7 
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5  ON 

QUESTIONS , ' 
'  , r,MAT[ROW; 


duiii Mate 


?  l  rundrill  h;fuhcjr;ki;k2»q»a»*»;c;m 
C13  A  CALLED  BT  SHOW }  CALLS  DRILL, PULL 
C23  A  REQUIRES  HOW-LOCAL  VARIABLES  STM ,  TYPE 
C3]  A  initialize  answer  counters 
[4]  c«-w«-q 

C5]  start; 

C63  A  EXTEND  STM  FOR  REDUCTION,  SCAN 
C  7 1  SYMM (SVM{ */\M' >/( '+-ri=' ) C?53 ) , syh 

C3]  R  FORMAT  FUNCTION  DISPLAY 

[9]  Fp(lfl»2)[M] 

CIO]  FUNCKR,3)f  *,SYM,' 

C113  A  SET  MULTIPLIER. 

C 123  mf?3 

C13]  A  FULL  RANDOM  NUMBER  ARGUMENTS 
C 143  *1<-1  full  l 

C 1 5 3  *2«-2  full  n 

[16]  A  IF  K 1  IS  EMPTY  VECTOR,  EXIT;  ELSE  GO  ON 

[17]  +0X(0=f f«l 

[18]  A  IF  TYPE  IS  MONADIC,  GO  TO  MONTY;  ELSE  GO  ON 

[19]  AMOHTYx l TYPE= ' M ' 

[20]  A  FORMAT  DYADIC  Q  /  A 

[21]  OKtU)  ,func  ,t«2 

[22]  ftFl ( t f  K1  )  »  STM, t , K2 

[23]  ■♦FUN 

[24]  A  format  monadic  o/a 

[25]  MONTY ; 

[26]  GpFUNC  ,  ft<2 

[27]  AFtSTM,t,K2 

[28]  A  FUN  DRILL 

[29]  run;q  drill  a 

[30]  A  PELETE  EXTRA  SYMBOL  (IF  ANY) 

[31]  SYMfltSYM 

C 323  A  IF  STOP  FLAG  IS  SET,  EXIT;  ELSE  GO  ON 


57 


[33]  ->Oxt= 2 

[343  ft  IF  WRONG  ANSWERS  >.3,  GO  TO  'REVi;  ELSE  GO  OH 

[353  4REVXIW13 

[363  ft  IF  RIGHT  ANSWERS  (  RETURN  TO  ‘START1;  ELSE  EH  I T 
[373  -»STARTX\C<1 
[383  -*0 

[393  fev; 

[403  QfCR, 'PLEASE  REVIEW  THE  DESCRIPTION  OF  THIS  FUNCTION  OR  TALK  WITH 
TOUft ■,££,*  INSTRUCTOR  BEFORE  RETURNING  TO  THIS  UNIT,' 

[413  *«-2 
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1?  2fP  PULL  M}F:;C;L}H  JEfFOOL 
Cl]  ft  CALLED  BY  RUMDRILL 

C23  ft  REQUIRES  NON-LOCAL  VARIABLES  SYM,  M 
[33  A  SET  DEFAULT  VALUE 
[4]  2H0 

[53  ft  P  IS  1  FOR  LEFT  ARG,  2  FQft  RIGHT  ARG 

C<S3  ft  5ET  multiplier  based  oh  m  from  i  to  3(E:-!CEPT  monadic  cl) 

C7]  MULTf(  (10*M-2)  jO.  1)C1  +  (5YMC1]£  1  TL  ’  )  A(TYPE='M'  )  a-(“1*SYM)  £  •  I  \j.\  1  ] 
C33  ft  M  IS  RANK  of  desired  random  array;  assign  rows  AND  COLUMNS  TO  R  A 
HD  C 

C  9  3  R  <•  ( 1 » 1 » 2 )  C  n  ] 

C 103  c«-(l,(l+M),2)[M] 

C113  ft  DETERMINE  LIMITS  BASED  ON  TYPE  OF  SYMBOL 

C123  fond; pool*. i o 

[133  pool<.pool,(SYM[13£  1  +  -xr L  *  < i  =  >  >*£ t* ‘  )/hultxh,o,-hm9 
C  1  4  3  POOL*- POOL,  (  (SYMC1]£  't  +  pKtSS'  )aF=2>/MULTxH,0,-H 
[153  pool*.pool,  ((SYMC13E  ‘  >aP=i  )/£,-ehU» 

[163  POOLfROOL, ( (SYMCi3t ’ I { l ftp ’ ) )/2f 3» 4 
[173  POOL4-POOL,  (SYMCllt  '*■'  )/MUL7xD,-D«-2»4»5r3 
c  183  poolrpool,  <SYMC1]£ '  v^*»'  )/  0  1 
[193  POOL*.POOL,  (  (SYMC13='«'  )  A  TYPEs  1  M  1  )/!,*»  3 
[203  4PZX\ (TYPEs'M' )vSYMC13/'«' 

[213  ft  ft  LUGE  FOR  LOGARITHM  —  K2  ALWAYS  A  POWER  OF  K1  (FOOL  IS  EMPTY) 

[223  POQLfPOOL, <(SYMC13='*' ) a(Type= ■ d • ) ap=i )/2,3i 10 
[233  4P2X\P=1 

[243  2«-(R,c)f  ((SYMC13  =  '*'  )a.type=-d  -  )/( ,  ft  l )  *?(p ,  x  i )  p  3 

[253  ft  XF  HO  numbers  in  pool,  exit;  else  go  on 

[263  PZ:-»0xi0=fPOOL 

[273  POOLPioOfPOOL 

E283  ft  provide  array  of  random  nrs 

C293  ZMRfC)fPoOL[(RxC)?i003 

V 
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7  Q  DRILL  A  j  B  ; SB  j  SO  j  L 
[1]  fl  CALLED  BY  RUM DRILL}  CALLS  SQUEEZE 

C23  n  requires  non-local  variables  c,w;  global  eg 
C3]  start: 

C4]  *M0 

C5]  fl  DISPLAY  DRILL  QUESTION 

[£]  ASK :0RCR, ‘ WHAT  IS  THE  RESULT  OF { 1 

C73  Q«-« 

C8]  0  IF  REROHSE  IS  'STOP',  GO  TO  'HALT'}  ELSE  GO  Oil 

[93  +  HALTX U  =  +  /  +  / 1  STOP '  o  , rSBfSQUEECE  B  +  fl 

CIO]  fl  ANSWER  IS  NULL,  GO  TO  WR }  ELSE  GO  ON 

C113  +WRX\0=TSB 

[12]  fl  CHECK  FOR  NUMERIC  RESPONSE 
C 13]  ckj+naxi (0s5B£ ' 1234567890."' )v*0£SB£ > 

C14]  ft  LENGTH  OF  RESPONSE  f  LENGTH  OF  GIVEN  ANSWER,  GO  TO  1 WR 1 j  ELSE 
GO  ON 

CIS]  +WRxi</,A)/f tlB 

C163  fl  IF  RESPONSE  3  GIVEN  ANSWER,  GO  TO  1 RT 1 ;  ELSE  GO  ON 
C 17]  +RTXI((,A)A.3,1B) 

C18]  «  answer  is  wrong;  display  answer 

[19]  WR : Q+ ' SORRY ,  CORRECT  ANSWER  IS*' 

C20]  n«-A 

C21]  fl  INCREMENT  WRONG  ANSWER  COUNTER  AND  RETURN  TO  R'JNDRILL 

[22]  w+w+i 
C23]  +0 

C24]  fl  answer  is  right;  display  message 
[25]  Rtjq+'CORrect; • 

C263  fl  increment  right  answer  counter  and  return 
C27]  c+c+i 
C  28  3  ->0 

[29]  NA*a+' SORRY,  THIS  ANSWER  NOT  ACCEPTABLE,  PLEASE  ENTER  A  NUMERIC  ANS 

WER,  ' 

[30]  4ASK 
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C313  ft  STOP  AT  STUDENT  REQUEST;  SET  FLAii  AND  EXIT 
[323  HALT;->0f  t>2 
7 
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v  try  sym;w;b;t;c;tw 
C13  a  calls#  by  show;  calls  rum 

[23  A  REQUIRES  NON-LOCAL  VARIABLES  ROW,  STM,  FNAME 

C33  tw«-o 

C43  RESTART  ;TW«-TW+1 

C53  A  GO  TO  OUCH  IF  RESTART  COUNTER  EQUALS  3 
[63  •♦OUCHx\TW  =  3 

[7]  ft  INITIALIZE  FLAGS  AND  WRONG  ANSWER  COUNTER 

[83  t<-c».wh) 

C93  A  REQUEST  STUDENT  INPUT  a  LOGICAL  expression  USING  THE  SYMBOL 
[103  start: 

C113  QpCR , 1 WRI TE  A  TRUE  STATEMENT  USING  ' , S YM , ' , ' , CR , • FOR  EXAMPLE;  4  =  2r 
2  1 

C 1 2 3  a  IR  response  is  'stop1,  go  to  ‘halt>;  else  go  on 
Cl  33  ->HALTxi4  =  +  /  +  /  'STOP  '  o  ,=Bt-n 

[143  A  IP  RESPONSE  IS  A  HULL  OR  A  NAME,  GO  TO  ‘WRONG'}  ELSE  GO  ON 

[153  •♦wrohgxi  (4/D'fC  B)Vo  =  f* 

C 163  A  SET  T=1  IF  STATEMENT  IS  TRUE 
C173  ne;<t;t*.i  =  1b 

C183  A  SET  C=1  IF  STATEMENT  CONTAINS  THE  SYMBOL 
[193  c«-stm£b 

[203  A  GO  TO  RIGHT  IF  T  AND  C  BOTH  EQUAL  [ }  ELSE  GO  ON 

[213  -»RIghtx\Tac 

[223  a  answer  is  wrong;  increment  counter 
[233  wrongjwfw+i 

[243  A  GO  to  rev  if  wrong  answer  counter  EQUALS  3 
C253  4REvxi«=3 

[263  A  60  TO  hosym  if  the  statement  is  true;  else  GO  ON 

[273  4H0SYMX\T 

C283  a  RRIht  error  msg 

C293  HTJQ<-' SORRY,  THIS  statement  is  NOT  TRUE,' 

C303  A  60  TO  HOSYM  IF  THE  STATEMENT  DOES  NOT  CONTAIN  THE  SYMBOL}  ELSE  GO 
ON 
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[313  ->MOSYMxt*C 

[323  ft  PRINT  MSG  AND  RETURN  TO  START 
[333  Qf 1  TRY  AGAIN,' 

[343  4ST  ART 

C353  A  PRINT  ERROR  MSG  AMD  RETURN  TO  START 

C363  NOSrM»Q(.  •  TOUR  ANSWER  DOES  HOT  USE  ',SYM,',  TRY  AGAIN,' 

[373  MSTART 

[383  ft  PRINT  MSG  AND  EXIT 
[393  RIOHT  CORRECT  J  < 

[403  40 

[413  B  PRINT  MSG  AND  RESTART 

[423  PEVJQfCR, 'DO  !OU  WISH  TO  REVIEW  THE  DESCRIPTION  OF  ',FHAME,'?' 
ENTER  Y  OR  H,' 

[433  R  IP  RESPONSE  15  HULL  OR:  NOT  Y,  GO  TO  RESTART,  ELSE  GO  ON 
[44]  ^RESTART* t0=f DpO 
[453  ARESTARTxi ' Y'^B 

[443  b  display  help  variable, then  restart 

[47]  RUN  ROW 

[483  ^restart 

[493  ft  three  restarts;  display  message  and  e:;it 

[503  OUCHJQr ' PLEASE  SEE  'OUR  INSTRUCTOR  FOR  ASSISTANCE,' 

[513  40 

[523  ft  STOP  AT  STUDENT  REQUEST;  SET  FLAG  AND  EXIT 

[533  halt;->o,yr2 
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7  TEST  HNH  ;  HOME  ;  0  f  Fait*  ;FIIAm£  f  Y  ;  RTJ  WT  J  QV  f  AV  J  TYPE  ;  AF.G;  S3 
Q]  fl  USED  TO  TEST  DRILL  j  CALLS  RUHDRILL,  TRY,  SQUEEZE 
C23  A  SET  VARIABLES  CORRESPONDING  TO  ROW 
C  3  3  ROWf((lfMATC;LESCOL3)=»(NH)/,  (f«AT)[n 
C4]  hane«-,mat[;row;ham£col] 

C 5  3  ENAME*.  SQUEEZE  , MA T [ ROW ; FNAMECOL  ] 

[63  SrM«-MAT[ROW)SlMCOL] 

[7]  RANK fMAT[ ROW ; 3VKAC0L] 

[g]  TYPE<.MAT[ROW;HDCOL] 

[9]  ARG«-MAT  [ROW  J  HKCOL  ] 

[103  1'MO 

c 1 1 3  ft  SCALAR  DRILL 

C  1  2  3  SDJ-»VX\J.Sl’M5SS4.l+~XrrLJ|-.\*<i=>>Rv^»^,P»' 

C  133  4Vx  \  (  (  S't'Mj  ■-*-*?,  '  )  aTYF'Es  1  H  '  ) v(  SYH{  *  l  '  )  ATYPEs  •  D  * 

[143  1  RUM DRILL  1 

[153  A  IF  FLAG  INDICATES  'STOP'  RESPONSE,  GO  TO  HALT;  ELSE  SO  OH 

[163  ->HALT  x'T  =  2 

[17]  V ; ^VDx \ (0=QWC  name; 

[133  A  VECTOR  DRILL 

[193  vd‘4Xx\  <*sym£ss,  •  ) v( (SY*{  •  ,  +  *  •  )  aTypes  <m<  ) »  <stms  •  /\/\ 

TYPE  = ' D ' 

[203  4  VS  X l  ( SYM  £  '  I  '  ) 

[213  1  Ruhdrill  2 

[223  A  IF  FLAG  INDICATES  'STOP'  RESPONSE,  GO  TO  HALT;  ELSE  GO  Oil 

[233  4Holtxt=2 

[243  vsj^vvx I (SYMf 'Oft*' ) ATYPE= ' M ' 

[253  4XX<(SYMS )vTYPE='M' 

[263  2  Ruhdrill  i 

[273  A  IF  FLAG  INDICATES  'STOP'  RESPONSE,  GO  TO  HALT;  ELSE  GO  ON 

[283  4Haltxy=2 
C 29 3  vv;4Xx\SYMf 1 ; • 

C303  2  ruhdrill  2 

C313  A  IF  FLAG  INDICATES  'STOP'  RESPONSE,  GO  TO  HALT;  ELSE  GO  OH 
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[32]  4HAi»Txr=2 

C 33 2  :i:4MDxi(0=D«c  name) 

[34]  MD*4Ax\-(5r«l ' f • )aTYFE: 1 V ' 
c 35 3  1  RUN DRILL  3 

C36]  n  *F  flag  indicates  'stop*  response,  go  to  halt;  else  go  oh 

[37]  -»haltxy=2 

[38]  ajqr' test  ok  > 

[39]  -+0 

[40]  HALTJCR,  1  THIS  TEST  HAS  SEEN  HALTED,* 

V 
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T 


r- 


9  Sbnextlesson; I  ;v 

Cl]  ftFIND  INDEX  OF  LAST  LESSON  IM  VECTOR  OF  LESSON  NUMBERS 
C2]  X«.(V<.t,MflTC;LESCOL])>LASTLESSOI» 

C3]  ((RETURN  NEXT  LESSON  NUMBER  IM  SEQUENCE 

C4  J  2*-V[I  +  n 

V 


9  ORDERMAT }OM ; ICOM 

C13  fl  SORTS  THE  VARIABLE  'MAT'  IH  ACSENX'XHG  ORDER  OF  LESSON  NUMBER 
c 2  3  «  CREATE  VECTOR  OF  LESSON  NR: S 

C 3 3  OM^jMATc;  (43 

[43  ft  FIND  INDEXES  OF  LESSONS  IN  ORDER 
[5]  ICOM(-±OM 

[£3  fl  REORDER  MAT  ACCORDING  TO  INDEXES 
[7]  MAT«-MAT[ICOM}  3 
9 


9  ClSGUEECE  STRING 

C13  0  CALLED  BT  HELP,  RUN,  TEACH,  SHOW,  SCORE,  DRILL 

[2]  ft  DELETES  BLANKS  IN  CHARACTER  STRING  ARGUMENT 
c  3  3  2(-<’  '  j!rSTRING)/,  STRING 

9 
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VARIABLES 


1 .  Global  v ar ia blss 

The  following  section  contains  all  of  the  glcoal 
variables  in  the  TUTOR  workspace  except  the  text  variables 
(part  C)  and  the  user's  guide  variables  called  by  rjs  START 
function  (appendix  A).  MAT  is  the  most  important  variable 
in  TUTOR,  as  it  is  called  on  to  cross-index  symbols,  lessor, 
numbers,  function  names,  and  selected  function  characteris¬ 
tics.  The  variables  with  names  ending  in  COL  index  the 
columns  of  MAT  for  use  in  the  functions,  so  that  these 
columns  can  be  rearranged  if  necessary.  CUSS  provides  ques¬ 
tions  for  use  in  the  ASK  function,  and  ail  of  the  - wo- 
letter,  underlined  variables  (except  CR)  contain  sets  of 
multiple-choice  answers  for  use  with  CUES.  The  other  impor¬ 
tant  global  variable  is  LASTLESSON  which  ns  giver,  a  value  by 
the  SHOW  function  to  indicate  the  last  lessor,  completed. 
All  other  variables  used  in  TUTOR  functions  are  local  vari¬ 
ables  at  some  level  of  the  calling  nierarchv. 


MAT 


101 

M 

H 

£ 

MEGA 

HEGATIVE_MUMBER 

102 

♦ 

M 

M 

A 

COM  J 

COM JUGATE 

103 

+ 

D 

H 

K 

A  A 

PLUS 

PLUS 

104 

- 

H 

W 

A 

CHAM 

CHAIIGE_S  IGM 

105 

- 

D 

N 

N 

A  M 

MI  MU 

MINUS 

106 

X 

M 

N 

A 

SIGH 

SIGHUM 

107 

X 

D 

M 

N 

A  A 

TIME 

TIMES 

108 

T 

M 

N 

A 

RECI 

RECIPROCAL 

10? 

- 

t< 

N 

N 

A  A 

GIVI 

DIVIDE 

121 

( ) 

M 

E 

A 

PARE 

PARENS 

1?? 

'  ■ 

M 

K 

V 

QUOT 

QUOTE 

123 

t- 

D 

K 

E 

V  A 

SPEC 

SPECIFICATION 

124 

f 

M 

E 

A 

SHAP 

SHAPE 

125 

f 

r> 

N 

E 

V  A 

RESH 

RESHAPE 

126 

[] 

D 

£ 

N 

A  A 

8RAC 

BRACKETS 

127 

* 

M 

E 

A 

RAVE 

RAVEL 

128 

f 

I» 

E 

E 

A  A 

CATE 

CATENATE 

129 

l 

M 

H 

V 

IMDE 

I N  D  E  X  _  G  E  N  E  R  A  T  O  P 

131 

/ 

M 

E 

A 

REI-2 

REDUCTION 

132 

+ 

M 

E 

A 

REI'i 

REDUCTION 

141 

* 

M 

N 

A 

EXPO 

EXPONENTIAL 

142 

* 

n 

N 

M 

A  A 

FOWE 

POWER 

143 

• 

M 

A 

NATU 

HATURAL_LOG 

144 

• 

D 

M 

H 

A  A 

LOGA 

LOGARITHM 

145 

0 

M 

H 

A 

PITI 

pi_times 

146 

0 

D 

H 

I! 

A  A 

GEOM 

GEOMETRIC 

147 

1 

» 

M 

N 

A 

FACT 

FACTORIAL 

148 

1 

» 

D 

N 

H 

A  A 

BINO 

BINOMIAL 

14? 

1 

M 

H 

A 

MAGH 

MAGNITUDE 

151 

\ 

M 

E 

A 

SCA2 

SCAN 

152 

M 

E 

A 

SC  A 1 

SCAN 

161 

r 

M 

M 

A 

CEIL 

CEILING 

162 

L 

M 

M 

A 

FLOG 

FLOOR 
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163 

r 

r< 

N 

H 

A 

A 

MAX  I 

MAXIMUM 

164 

L 

r> 

N 

II 

A 

A 

MIIII 

MINIMUM 

165 

i 

D 

H 

H 

A 

A 

REST 

RESIDUE 

166 

i 

M 

N 

V 

GRUP 

GRAB E_UP 

167 

9 

M 

H 

V 

GRAB 

G  R  A  D  E  _  D  O  W 1 1 

168 

? 

M 

H 

A 

ROLL 

ROLL 

169 

? 

D 

M 

H 

S 

S 

BEAL 

BEAL 

180 

= 

b 

e 

E 

A 

A 

EG  J  A 

EQUAL 

181 

D 

E 

E 

A 

A 

MOTE 

MOT_EGUAL 

182 

< 

D 

N 

H 

A 

A 

LESS 

L£SS_THAM 

183 

t 

D 

M 

H 

A 

A 

LTEG 

LES5_0R_EQUAL 

184 

D 

II 

N 

A 

A 

GTEG 

greater_or_equal 

185 

> 

D 

H 

M 

A 

A 

GREA 

GREATER_THA/< 

191 

H 

M 

B 

A 

MOT 

MOT 

192 

A 

I' 

B 

B 

A 

A 

A  MB 

AMD 

193 

A 

D 

B 

B 

A 

A 

HAND 

MAUD 

194 

V 

D 

B 

B 

A 

A 

OR 

OR 

195 

¥ 

D 

B 

B 

A 

A 

NOR 

;ior 

196 

s 

B 

E 

E 

A 

A 

MEHB 

MEMBER.  OF 

201 

6 

M 

E 

A 

REV2 

REVERSE 

202 

8 

M 

E 

5 

RE  V  1 

REVERSE 

203 

* 

B 

M 

E 

A 

A 

ROT2 

ROTATE 

204 

a 

B 

H 

E 

A 

A 

ROT  1 

ROTATE 

205 

19 

M 

E 

A 

TRAM 

TRANSPOSE-MONADIC 

206 

9 

0 

H 

E 

V 

A 

TRAB 

TRANSPOSE-DYADIC 

211 

+ 

D 

H 

E 

V 

A 

TAKE 

TAKE 

212 

+ 

D 

N 

E 

V 

A 

BROP 

BROP 

213 

/ 

B 

B 

E 

V 

A 

COM2 

COMPRESS 

214 

/ 

n 

B 

E 

V 

A 

COM  J 

COMPRESS 

215 

\ 

D 

B 

E 

V 

A 

EXP  2 

EXPAND 

216 

D 

B 

E 

V 

A 

EXP  1 

EXPAND 

219 

* 

B 

E 

E 

A 

A 

LAM  I 

LAMINATE 

231 

a 

M 

H 

y% 

MATI 

MATRIX_IH VERSE 

232 

a 

D 

M 

N 

V 

X 

MATB 

MATRIX_DI VIBE 
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241 

«  . 

B 

E 

E 

A 

A 

ours 

OUTER_ PRODUCT 

24  2 

* 

B 

E 

E 

A 

A 

I  HUE 

IHWER_PROBUCT 

301 

\ 

B 

E 

E 

V 

A 

IMDO 

IHt EX_OF 

304 

T 

B 

N 

N 

A 

A 

E  ICO 

ENCODE 

305 

J. 

B 

H 

K 

A 

A 

DECO 

DECODE 

306 

i 

M 

K 

V 

EXEC 

EXECUTE 

307 

t 

B 

H 

H 

V 

A 

DTFO 

FORMAT -DYADIC 

308 

* 

M 

E 

A 

FORM 

FORMAT-MONADIC 
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LESCOL 


12  3  4 

STMCOL 

3 

* 

MDCOL 

12 

♦ 

MK  COL 

16  18 

SVXACOL 

22  24 

HAMECOL 

28  29  30  31 

FNAMECOL 

35  36  37  38  39  40  41  42  43  44  45  46  47  48  49  50  51 
» 
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CUES 


■HOW  MANY  ARGUMENTS  DOES  THE  • ,FMAME,‘  FUNCTION  TAKE?' 

■DOES  Sl‘,StM,'S2  EQUAL  S? 1 , STM , • S 1 ? 1 

'IF  ONE  ARGUMENT  IS  A  VECTOR,  THE  OTHER  ARGUMENT  MAT  BE  SCALAR  OR  VECTOR 
.  (T/F)' 

•IF  ONE  ARGUMENT  IS  A  MATRIX ,  THE  OTHER  ARGUMENT  MUST  BE  A  SCALAR1, CP,1 
OR  A  MATRIX  OF  THE  SAME  SHAPE,  (T/F)' 

■WHAT  RANK  CAM  THE  LEFT  ARGUMENT  OF  '  , FN AME ,  '  BE  ? '  ,  R  K 

'WHAT  RANK  CAN  THE  RIGHT  ARGUMENT  OF  ' , FNAME , •  BE?',RK 

'DO  THE  ARGUMENTS  ALWAYS  HAVE  TO  HAVE  THE  SAME  RANK? ' 

'CAN  '  | F  NAME ,  '  TAKE  CHARACTER  ARGUMENTS?' 

'IF  SO,  WHICH  ARGUMENT ( S )  CAN  BE  CHARACTER? ‘ , AR 

'DOES  ' , FNAME , ‘  TAKE  BOOLEAN  (l  OR  0)  ARGUMENTS?' 

'IF  SO,  WHICH  ARGUMENT ( S )  MUST  BE  BOOLEAN? ', AR 

.SB 

EMTER  R  FOR  RIGHT, 

L  FOR  LEFT,  OR 
B  FOR  BOTH 
,RK 

EHTER  S  FOR  SCALAR 
V  FOR  VECTOR 
X  FOR  MATRIX 
A  FOR  ANY  RANK 
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2.  Text  variables 

The  following  global  variables  contain  the  basi 
text  of  the  T0TO3  course.  They  are  printed  in  the  sea 
oriar  as  the  lessons.  The  header  above  each  variable  is  no 
part  of  the  text;  it  lists  the  lesson  number,  the  shor 
title  of  the  variables,  and  the  fall  name  of  the  function 
The  first  column  control  characters  are  omitted  here. 
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NEGATIVE  NUMBER 


N  E  G  A 


THE  SYMBOL  “  ( UPSHIFT  2)  IS  USEE  ONLY  TO  ENTER  NEGATIVE  NUMBERS, 
IT  CAN  BE  USED  ONLY  IN  FRONT  OF  SCALARS  (SINGLE  NUMBERS), 

NOT  VARIABLE  NAMES,  ARITHMETIC  EXPRESSIONS,  OR  ARRAtS, 

TO  CHANGE  ARITHMETIC  SIGN  USE  THE  SYMBOL  -  (UPSHIFT  +), 
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CONJUGATE 


THE  SYMBOL  +  IS  USES  FOR  THE  MONADIC  CONJUGATE  FUNCTION, 

THIS  IS  AH  IDENTITY  FUNCTION  WHICH  RETURNS  ITS  ARGUMENT,  AFTER 

EVALUATION  IF  NECESSARY,  IT  TAKES  NUMERIC  ARGUMENTS  OF  AMY  RANK, 


example;  +2  =>  2 


+"3+2  =>  "1. 
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I 
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PLUS 


PLUS 


,  ,  ,  . . .  ,  ,  . . . .  *  . .  . . . . .  ,  ,  ,  , 

THE  SYMBOL  +  IS  USED  FOR  THE  DYADIC  PLUS  FUNCTION, 

THIS  PERFORMS  SIMPLE  ADDITION  ON  NUMERIC  ARGUMENTS  OF  ANY  RANK, 

for  example;  2+2  =>  4  spacing  is  not  important, 

TO  ADD  A  SCALAR  TO  EACH  ELEMENT  OF  A  VECTOR,  ENTER  EITHER  S+v  OR  V+S, 


V1+V2  WILL  ADD  TWO  VECTORS  ELEMENT 

2+(3  4  5)  =>  5  6  7  (34 

(3  4  5)+<5  6  7)  =>  8  10  12 

IF  THE  TWO  VECTORS  BEING  ADDED  ARE 
YOU  WILL  GET  A  'LENGTH  ERROR', 

MATRIX  ADDITION  IS  DONE  AS  FOLLOWS; 
S+M  OR  M+S  WILL  ADD  THE  SCALAR  S  TO 

for  example;  if  m  =  >  1  2  then  3+m 

3  4 

M1+M2  WILL  ADD  THE  MATRIX  MJ  TO  THE 
FOR  EXAMPLE;  IF  :)  1  2  AND  M2 

3  4 

Ml  AND  MO  MUST  BE  THE  SAME  SHAPE  OP 
TRYING  TO  ADD  A  VECTOR  TO  A  MATRIX  t 

THESE  PRINCIPLES  CAN  BE  EXTENDED  TO 


BY  ELEMENT,  FOR  EXAMPLE; 

5 ) +2  =>  567 

IOT  THE  SAME  LENGTH, 


EACH  ELEMENT  OF  THE  MATRIX  M, 

=  .•  .)5  AND  M  +  3  =>4  5 

6  7  6  7 

MATRIX  M2,  ELEMENT  BY  ELEMENT, 
=>34  THEN  Ml+MO  =>43 

5  6  3  10 

A  'LENGTH  ERROR'  WILL  RESULT, 
ILL  RESULT  IN  A  'RANK  ERROR’, 

HIGHER  LEVEL  ARRAYS, 


f 
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CHANGE  SIGN 


CH6.! 


THE  STMBOL  -  (UPSHIFT  +  )  IS  USEI>  FOR  THE  MONADIC 
THIS  CHANGES  THE  ARITHMETIC  SIGH  OF  ITS  NUMERIC 

FOR  example;  -(1  ~2  3)  =>  "1  2  ~3. 

NOTE  THE  DIFFERENCE  BETWEEN  -  AND  "  (UFSHIFT  2) r 
NEGATIVE  NUMBERS, 


CHANGE  SIGH  FUNCTION, 
ARGUMENT  OF  ANT  RANK, 

WHICH  INDICATES 
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MINUS 


m  i ; 1  u 


THE  SYMBOL  -  (UPSHIFT  +)  IS  USED  FOP  THE  DYADIC  MINUS  FUNCTION, 
IT  PERFORMS  SIMPLE  SUBTRACTION  ON  NUMERIC  ARGUMENTS  OF  Ail:  RANK, 


for  example;  5-2  =  >  3 


”10-”2  =>  "3 


TO  SUBTRACT  A  SCALAR  FROM  EACH  ELEMENT  OF  A  VECTOR,  ENTER  V-S, 

TO  SUBTRACT  EACH  ELEMENT  OF  A  VECTOR  FROM  THE  SAME  SCALAR,  ENTER 
V1-V2  WILL  SUBTRACT  EACH  ELEMENT  OF  V;  FROM  THE  CORRESPONDING 
ELEMENT  OF  VJ, 

VI  AMD  V2  MUST  BE  THE  SAME  LENGTH  OR  YOU  WILL  GET  A  'LENGTH  ERROR 

FOR  example;  (345) -2  =>  123  2- (345)  ->  *1  "2  ~ 

(6  7  8 ) - ( 1  23)  =>  555 


ENTER  M-S  TO  SUBTRACT  THE  SCALAR  S  FROM  EACH  ELEMEM’’  OF  THE  M  A  T  R I 
ENTER  S-M  TO  DO  THE  OPPOSITE, 

FOR  example;  IF  M  s>  1  2  THEM  4-M  a;  32  AMD  M-2  a)  "1  0 

3  4  10  12 

M 1 -M2  SUBTRACTS  MATRIX  M2  FROM  MATRIX  Ml,  ELEMENT  BY  ELEMENT, 

for  example;  if  =>  ;  2  and  m2  =>  3  4  then  M2-mi  =>  2  2 

3  4  5  6  2  2 

IF  Ml  AND  M2  ARE  HOT  THE  SAME  SHAPE,  A  'LENGTH  ERROR'  WILL  RESULT 
TRYING  TO  SUBTRACT  A  VECTOR  FROM  A  MATRIX  OR  VICE-VERSA  MILL 
PRODUCE  A  'RANK  ERROR', 


THESE  PRINCIPLES  CAN  BE  EXTENDED  TO  HIGHER  LEVEL  ARRAYS, 
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3IGMUM 


SIGH 


. .  »  .  . . . . ,,,,,,,  X  . . 

THE  SYMBOL  X  IS  USES  FOP:  THE  MONADIC  SIGNUM  FUNCTION, 

IT  RETURNS  THE  ARITHMETIC  SIGH  OF  THE  ARGUMENT;  1  FOP:  POSITIVE  NUMBERS, 
"1  FOR  NEGATIVE  NUMBERS,  AMD  Q  FOR  ZERO  VALUES, 

IT  TAKES  NUMERIC  ARGUMENTS  OF  ANY  RANK, 

FOR  example;  x ( 3  "2)  =>  1  "1  x(3+2-5)  =>  0 
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f 
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TIMES 


T  IME 


,  ,  ,  ,  . . , .  X  . .  ,  ,  , 

THE  SYMBOL  X  IS  USE!'  FOR  THE  DYADIC  TIMES  FUMCTICH, 

THIS  PERFORMS  SIMPLE  MUL T IPL I C AT  I  OH  Oil  HUMERIC  ARGUMENTS  OF  ANY  RANK, 

FOR  EXAMPLE;  2*4  =>  8  ORDER  AMD  spacing  are  hot  important, 

TO  MUL  TIP  Y  EACH  ELEMENT  OF  A  VECTOR  BY  A  SCALAR,  ENTER  SxV  OR  V  /.  S  , 
V^xV2  RESULTS  IN  THE  PRODUCT  OF  CORRESPONDING  ELEMENTS  OF  VJ  AND  VO, 


FOR:  EXAMPLE  • 

3  x  ( 

4 

* 

n 

3 ) 

=  >  3 

6  9 

(1  2 

3)x2 

->  3  6 

9 

<1 

O 

3)  x  ( 2 

4  6) 

=  >  2 

2  i  r> 

u  A  u 

IF  V 1  AND  V2 

ARE 

HOT 

THE 

SAME 

LENGTH , 

YOU 

WILL 

GET  A 

*  LENGTH 

ERROR 

EITHER  M  x  S  OR  SxM  WILL  MULTIPLY  A  MATS  I X  BY  A  SCALAR, 
THE  RESULT  WILL  BE  A  MATRIX  THE  SAME  SHAPE  AS  M, 


FOR  example; 

IF  M 

=  > 

1  2 

THEN  3XW  => 

3  6  A  N I*  M  X  3  -  ' 

vj 

6 

3  4 

?  12 

9  l 

2 

M^xMO  WILL  RETURN 

THE 

PRODUCT  OF  CORRESPONDING  ELEMENTS  IN 

*1 

A, ID  M2 

M^  AND  M2 

MUST 

BE 

THE 

SAME  5HAPE  OR 

YOU  WILL  GET  A  ' LENG 

TH 

ERROR ’ 

for  example; 

IF 

Ml  = 

>  1 

2  AND  M2  => 

3  <\  THEN  Mix  M2  => 

3 

3 

3 

4 

5  6 

15 

24 

IT  IS  IMPORTANT  TO  NOTE  THAT  MULTIPLYING  MATRIXES  WILL  HOT  RESULT  IN 
•MATRIX  MULTIPLICATION'  (INNER  PRODUCT  OR  DOT  PRODUCT), 

FOR  INFORMATION  ON  INNER  PRODUCT.  REQUEST  HELP  OH  * , •  (DOT  OR  PERIOD), 
MULTIPLYING  A  VECTOR  WITH  A  MATRIX  WILL  RESULT  IN  A  'RANK  ERROR', 

THESE  PRINCIPLES  CAN  BE  EXTENDED  TO  HIGHER  LEVEL  ARRAYS, 
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RECIPROCAL 


THE  SYMBOL  -  (UPSHIFT  +)  IS  USED  FOR  THE  MONADIC  RECIPROCAL 
THIS  RETURNS  THE  RESULT  OF  1  DIVIDED  BY  THE  ARGUMENT, 

ITS  ARGUMENT  MUST  BE  NUMERIC  AND  CAN  3 E  OF  ANY  RANK, 
HOWEVER,  IF  THE  ARGUMENT  HAS  VALUE  Q,  A  'DOMAIN  ERROR'  WILL 

FOR  example;  -(123)  =  >  i  0.5  0.332333333 


i 


it  :c  r 


FUNCTION , 


RESULT  , 


10? 


DIVIDE 


D  I  7 


THE  SYMBOL  A  (UPSHIFT  x)  13  USED  FOP:  THE  DYADIC  DIVISION  FUNCTION, 

IT  PERFORMS  SIMPLE  DIVISION  OH  NUMERIC  ARGUMENTS  OF  ANT  RANK, 

FOR  example;  63-2  =>  3  _10-~4  =>  2.5 

DIVIDING  BY  0  RESULTS  IN  A  'DOMAIN  ERROR',  EXCEPT  THAT  Q-Q  =;  , 

TO  DIVIDE  A  SCALAR  BY  EACH  ELEMENT  OF  A  VECTOR,  ENTER  S-V, 

TO  DIVIDE  EACH  ELEMENT  OF  A  VECTOR  BY  THE  SAME  SCAuAF:,  ENTER  V-S, 
V<^.V2  DIVIDES  EACH  ELEMENT  OF  V  J  BY  THE  CORRESPONDING  E_SMEMT  OF  vo, 
VI  AND  V2  MUST  BE  THE  SAME  LENGTH  OR  YOU  WILL  GET  A  'LENGTH  ERROR', 

FOR  example;  (345) 32  =>  1.522,5  ;-(3  4  5)  1,75.6 

(3  6  9)3(1  23)  =>  333 

ENTER  Sam  TO  DIVIDE  THE  SCALAR  S  BY  EACH  ELEMENT  OF  THE  MATRIX  M, 

Mas  WILL  DIVIDE  EACH  ELEMENT  OF  M  BY  S,  BOTH  OPERATIONS  RESULT  IN 
A  MATRIX  THE  SAME  SHAPE  AS  M, 


FOR 

example; 

IF  M  => 

1 

7 

THEM  2-M  =>  2 

1 

AND  M-2 

= 

'  C .  5 

1 

4 

5 

0.5 

0  *  4 

7  #  r 

Ml  A 

M2  DIVIDES 

MATRIX 

Ml 

BY 

MATRIX  M2,  ELEMEi 

1 T  Em 

ELEMENT , 

FOR 

example ; 

IF  Ml 

-  > 

2 

4 

AND  M2  =>  12 

THEN 

M 1 -M2  = > 

7 

7 

6 

9 

3  4 

n 

7 

IF  Ml  AND  M2  ARE  NOT  THE  SAME  SHAPE,  A  'LENGTH  ERROR'  WILL  RESULT, 
TRYING  TO  DIVIDE  A  MATRIX  BY  A  VECTOR  OR:  VICE-VERSA  WILL  PRODUCE  A 


'RANK  ERROR', 


THESE  PRINCIPLES  CAN  BE  EXTENDED  TO  HIGHER  LEVEL  ARRAYS, 
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RARE  N S 


P  Ar.  E 


.  ()  . 

PARENTHESES  ARE  USED  TO  GROUP  SYMBOLS  FOR  CORRECT  PROCESSING  BY 

THE  APL  INTERPRETER, 

APL  DIFFERS  FROM  EVERY  OTHER  COMPUTER  LANGUAGE  IN  THE  NAY  IT 
DETERMINES  WHICH  OPERATION  IS  PERFORMED  FIRST, 

IT  SIMPLY  READS  FROM  RIGHT  TO  LEFT  — ' BACKWARDS ' — AND  PERFORMS  EACH 
OPERATION  AS  IT  GOES  ALONG, 


FOR  example; 

3x2+1  =>  ? 

BECAUSE 

2+1  => 

3 

A  H  I» 

3x3 

1+2x3  =>  7 

BECAUSE 

2X3  =i 

6 

AH  D 

1+6 

PARENTHESES  APE  USED  TO  OVERRIDE  THIS  R I GHT -TO-LEF T  RULE, 
FOR  example;  =>  ?  and  (1y2)x3  =>  ? 

EXPRESSIONS  WITHIN  PARENTHESES  ARE  EVALUATED  FIRST  — 

ALSO  FROM  RIGHT  D  LEF", 

USING  the  RIGHT-TO-lEFT  rule  CAN  ELIMINATE  parentheses, 


BUT  USING  PARENTHESES  GENEROUSLY  CAN  ELIMINATE  CONFUSION. 


QUOTE 


CtUOT 


122 


THE  QUOTE  MARK  '  (UPSHIFT  K)  IS  USED  TO  E, '(CLOSE  CHARACTER  BATA, 

AFL  ASSUMES  THAT  LETTERS  (OR  COM  B 1 1!  AT  I  OHS  OF  LETTERS  AIII>  NUMBERS) 

ARE  VARIABLE  OR  FUNCTION  NAMES  UNLESS  THEY  ARE  ENCLOSE:.  IN  QUOTES, 
FOP  EXAMPLE;  IN  THIS  TUTORIAL, 

HOW  -}  (THE  VARIABLE  MAMED  HOW) 

1  HOW  1  = >  HOW 

YOU  CAN  ALSO  USE  SYMBOLS  SUP  NUMBERS  AS  CHARACTER  DATA, 
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SPECIFICATION 


S  f  E  C 


. . . . . .  *-  . . . . . 

THE  SYMBOL  (-  IS  USED  FOR  SPECIFICATION, 

IT  ASSIGNS  ’HE  VALUE  OF  THE  RIGHT  ARGUMENT  TO  THE  VARIABLE  MAME 
WHICH  15  the  LEFT  ARGUMENT, 

THE  VARIABLE  NAME  CA  cl  BE  ANY  COMBI  HAT  I  OH  OF  LETTERS  AMD  NUMBERS  (HO 
SYMBOLS  AMD  HO  SPACES)  WHICH  BEGINS  WITH  A  LETTER,  LENGTH  IS 
EFFECTIVELY  UNLIMITED, 

THE  RIGHT  ARGUMENT  CAN  BE  EITHER  CHARACTER  OR  NUMERIC,  OF  ANY  RANK, 
TO  SPECIFY  A  CHARACTER  VARIABLE,  ENCLOSE  THE  RIGHT  ARGUMENT  IN 
SINGLE  QUOTES  (')  UNLESS  IT  IS  ANOTHER  CHARACTER  VARIABLE, 


NOTE  THAT  THE 

VARIABLE 

CAN 

BE  USED  IN  THE  SAME  LINE  AS 

THE  VALUE 

SPECIFIED , 

FOft  IT*' AMP  LE 

: 

Nt-3+ 1  -2 

RE SUL’S 

IN 

•  «  HAVING  VALUE  2  I  HAVING 

VALUE  5 

RESULTS 

IN 

A,  Y,  AND  2  ALL  HAVING  VALUE 

1 

Vt;  o  3 

RESULTS 

IN 

V  HAVING  VECTOR  VALUE  (123) 

' AFL 1 

RESULTS 

IN 

V*  BEING  A  CHARACTER  VECTOR) 

APL 

v  2  f-  v  i 

results 

I  M 

V 2  BEING  A  CHARACTER  VECTOR* 

AF  L 

SEE  HELP  ON  ; 

(UPSHIFT 

ft; 

FOR  INFORMATION  OH  SPECIFYING 

MATRIX 

VARIABLES, 
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shape 


SH  Ap 


. . . . .  f  . . . 

'HE  SYMBOL  f  IS  USED  f  OF  THE  MONADIC  SHAPE  FUNCTION, 

THIS  RETURNS  A  DESCRIPTION  OF  THE  SIZE  OF  ITS  ARGUMENT,  WHICH  C AH 
BE  NUMERIC  OS  CHARACTER,  OF  ANT  RANK, 

THE  S'*  M  E  OL  CAN  EE  USED  TWICE  (ffA)  TO  RETURN  THE  RANK  OF  ITS  ARGUMENT, 

IF  THE  -  S' r  IS  A  SCALAR,  fS  RETURNS  NO  HUMBER  (AN  EMPTY  VECTOR), 
BECAUSE  A  SCALAR  HAS  HO  DIMENSION,  ffS  =>  Q 

ENTERING  , V  RETURNS  ONE  HUMBER  WHICH  REPRESENTS  THE  LENGTH  OF 
THE  VECTOR'S  ONE  DIMENSION,  //V  =>  1 

THE  SHAPF  OF  MATRICES  IS  EXPRESSED  AS  A  TWO-ELEMENT  VECTOR, 

THE  FIRST  ELEMENT  EQUALS  THE  HUMBER  OF  ROWS  (THE  LENGTH  OF  THE 
FIRST  DIMENSION),  AND  THE  SECOND  ELEMENT  EQUALS  THE  NUMBER  OF 
COLUMNS  (THE  LENGTH  OF  THE  SECOND  DIMENSION), 

FOR  EXAMPLE)  IF  M  r>  }  O  3  THEN  fM  =>  2  3  A  N  D  j>  f  M  =)  D 

4  5  6 

FOR  HIGHER-LEVEL  ARRAYS,  •«  WILL  BE  A  VECTOR  WITH  AS  MANY  ELEMENTS  AS 
A  HAS  DIMENSIONS,  THE  NUMBER  OF  COLUMNS  WILL  ALWAYS  BE  THE  LAST 
ELEMENT  OF  fA,  THE  NUMBER  OF  ROWS  WILL  ALWAYS  BE  THE  HEX T-TO-L AST 
ELEMENT,  PRECEDED  BY  THE  NUMBER  OF  'PAGES'  OR  PLANES,  PRECEDED  BY 
THE  NUMBER  OF  'BOOKS'  OR  SPACES,  AND  SO  ON, 

FOR  EXAMPLE)  IF  0  IS  A  4- D I  MENS  I ONAL  ARRAY,  ffD  = ,  4, 

if  f  d  =>  5  3  4  2  then  :•  has  5  bocks,  each  with  3  pages,  each  of 

WHICH  HAS  4  ROWS  AND  2  COLUMNS,  (THIS  WOULD  BE  DISPLAYED  AS 
FIFTEEN  SUCCESSIVE  4x2  MATRIXES — THE  FIRST  THREE  BEING  THE  FIRST 
BOOK,  THE  SECOND  THREE  BEING  THE  SECOND  BOOK,  ETC.) 
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RESHAPE 


re:h 


. . . .  f  . . . . . 

THE  SYMBOL  f  IS  USED  FOP:  THE  DYADIC  RESHAPE  FUHCTIOH, 

THIS  TAKES  THE  ELEMENTS  OF  THE  RIGHT  ARGUMENT  AND  REARRANGES  THEM 
ACCORDING  TO  THE  SHAPE  SPECIFIED  BY  THE  LEFT  ARGUMENT, 

THE  LEFT  ARGUMENT  MUST  BE  AN  INTEGER  SCALAR  OR  A  VECTOR  OF  INTEGER 
ELEMENTS , 

THE  RIGHT  ARGUMENT  CAN  BE  NUMERIC  OR  CHARACTER,  CF  ANY  RANK, 

IF  THE  LEFT  ARGUMENT  IS  A  SCALAR,  THE  RESULT  WILL  BE  A  VECTOR  WITH 

LENGTH  EQUAL  TO  THE  SCALAR,  CONSISTING  OF  THE  ELEMENTS  OF  THE  RIGHT 
ARGUMENT,  TAKEN  IN  ORDER  TOP  LEFT  TO  BOTTOM  RIGHT, 

WHEN  THERE  s,p:E  hot  ENOUGH  ELEMENTS  IN  THE  RIGHT  ARGUMENT, 

THE  FUNCTION  WILL  START  OVER  ANI  TAKE  THE  ELEMENTS  IN  ORDER  AGAIN, 
AS  MANY  TIMES  AS  NECESSARY  TO  FILL  THE  VCCTOP, 

FOR  EXAMPLE;  4f 1  =:  1111 

4» ( 1 AB 1 )  s )  ABAB 

IF  THERE  ARE  TOO  MANY  ELEMENTS  ON  THE  RIGHT,  THE  EXTRAS  ARE  OMITTED, 

FOR  example  j  2/(1  2  a  4)  -i  1  2 

if  THE  LEFT  ARGUMENT  IS  A  VECTOR,  THE  ELEMENTS  INDICATE,  IN  ORDER, 
LENGTH  OF  EACH  DIMENSION  IN  THE  RESULT, 

for  example;  i  2fl  2  3  4  =>  12 

3  4 

THIS  IS  ONE  WA  f  TO  ENTER  MATRIXES  OR  ARRA'lS  OF  HIGHER  DIMENSION, 

USING  A  MATRIX  OR  HIGHER-LEVEL  ARRAY  AS  THE  LEFT  ARGUMENT  OF  RESHAPE 


WILL  RESULT  IN  A  'RANK  ERROR' 


BRACKETS 


B  ft  ft  C 


.  []  . 

Dl'M'XC  SCIUAFE  BRACKETS  ARE  USE  I'  TO  I H  I'  E  X  THE  ELEMENTS  OF  AN  ARRAY, 

THEY  CAN  PE  THOUGHT  OF  AS  ENCLOSING  SUBSCRIPTS, 

THE  LEFT  ARGUMENT  (LEFT  CF  THE  BRACKETS)  CAM  BE  A  NUMERIC  OR  CHARACTER 
ARRAY  OF  ANY  RANK,  BUT  NOT  A  SCALAR,  INDEXING  A  SCALAR  KILL  RESULT 
IN  A  ‘RANK  ERROR’, 

THE  RIGHT  ARGUMENT  (BETWEEN  THE  BRACKETS)  MUST  BE  ONE  Oft  MORE 

INTEGER  SCALARS  OR  VECTORS,  SEPARATED  BY  SEMICOLONS  (  j  )  ,  THERE 
MUST  BE  AS  MAltr  SCALARS,- VECTORS  AS  THERE  ARE  DIMENSIONS  IN  THE 
LEFT  ARGUMENT,  OR  A  ‘RANK  ERROR '  KILL  RESULT, 

AH  t  NUMERIC  EXPRESSIONS  WITHIN  THE  BRACKETS  WILL  BE  EVALUATED  AS  IP 
THC  BRACKETS  AND  SEMICOLONS  ARE  PARENTHESES, 

BRACKETS  CAN  At  SO  PE  USED  FOLLOWING  THESE  SYMBOLS;  ,/\A4>9 
FOR  MORE  INFORMATION,  SEE  HELP  ON  THE  APPROPRIATE  SYMBOL, 

FCR:  EXAMPLE;  IF  V  IS  A  VECTOR  KITH  VALUE  (3  4  5  5), 

•-[i 2  =>  3  2:  =>  3  4  v C 1  +  2 2  ->  5  V[13+VC23  =  >  7 

1  A  PROGRAMMING  LANGUAGE' [1  3  153  =,  PPL 

THERE  IS  ONLY  ONE  SCALAR  OR  VECTOR  WITHIN  THE  BRACKETS  BECAUSE 
VECTORS  HAVE  ONLY  ONE  DIMENSION, 

MATRIXES  P:  E  0  U  I P:  E  TWO  SUBSCRIPTS  —  TKO  SCALARS  OR  VECTORS,  SEPARATED 
BY  A  SEMICOLOM( J  )  ,  WITHIN  THE  BRACKETS, 

THE  FIRST  SUBSCRIPT  REFERS  TO  THE  ROW,  THE  SECOND  TO  THE  COLUMN, 

FOP  example;  IF  m  =>  12  3  then  M[i;i3  =>  i  and  k[;  342]  =>  2  3 

4  5  6 

7  8  9 

TO  SELECT  AN  ENTIRE  ROW  (OR  ROWS),  ENTER  THE  ROW  SUBSCRIPT  FOLLOWED 
BY  A  SEMICOLON,  WITH  NO  COLUMN  SUBSCRIPT, 

FOR  example;  m[i  4  3  =)  12  3 

FOR  ENTIRE  COLUMH(S),  LEAVE  THE  ROW  SUBCRIPT  BLANK  AWP  ENTER  A  SEMI¬ 
COLON  FOLLOWED  B  Y  THE  COLUMN  SUB SCR  I PT ( S )  , 
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FOR  EKAMFLE;  if  m  1  FOR  THEM  H1C»1!1  =>  FrI 

T  OUR 
I HF  O 

MOT!  CG  THAT  ONE  RC'jI  OR  ONE  COLUMN  OF  A  H  A  T  R  I K  IS  SIMFLr  A  VECTOR, 
MOT  A  IxC  PR  E  x 1  MATRIX.  A  SINGLE  ELEMENT  OF  A  MATRIX  IS  fi 
SCALAR,  MOT  A  1  ;<  j,  MATRIX  OR  A  VECTOR  OF  LENGTH  1, 

THE  USE  OF  BRACKETS  CAN  BE  EXTENDED  TO  HIGHER  DIMENSIONS  FT  ADDING 
A  SEMICOLON  AMD  A  SCALAR  OR  VECTOR  FOR  EACH  I>  I  MENS  I  OH  . 

FOR  EXAMPLE,  IF  = ;  2  2  4  5 »  THE  SECOND  BOOK ,  THIRD  RAGE,  FIRST 
(ALL  COLUMNS)  CAN  BE  SELECTED  BT  ENTERING  M[2>3rlr3. 


ROW 
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RAVEL 


R«ve 


THE  SYMBOL  ,  IS  USED  FOP:  THE  MONADIC  RAVEL  FUNCTION, 

THIS  FUNCTION  CHANGES  ITS  ARGUMENT  TO  THE  FORM  OF  A  VECTOR, 
EITHER  NUMERIC  OR  CHARACTER  ARGUMENTS  OF  ANY  RANK, 

TO  CHANGE  A  SCALAR  TO  A  VECTOR.  OF  LENGTH  1,  ENTER  ,5. 

FOR  C '  AMPLE;  ?  f  3  s',  Q  BUT  f  f- 1 2  =  >  1 

THIS  CAN  BE  USEFUL  TO  ENSURE  THAT  A  VARIABLE  IS  A  VECTOR  WHEN 
USING  A  SCALAR  WOULD  LEAD  TO  AN  ERROR  (E.G.,  I  NO ELI MG )  , 


VECTORS  P  CHAIN  UNCHANGED  BY  RAVELLING, 

MATRICES  ARE  CHANGED  INTO  A  SINGLE  LONG  VECTOR,  STARTING  WITH 
TOP-  ROW  h  M  r»  READING  ACROSS  EACH  ROW  FROM  LEFT  TO  RIGHT, 

for  enamels;  if  *1  =:  l  2  then  f mj  s>  1234 

3  4 

THESE  PRINCIPLES  CAN  RE  EXTENDED  TO  HIGHER  LEVEL  ARRAYS, 


IT  TAKES 


THE 


90 


catenate 


CATE 


In  n 


THE  SYMBOL  ,  IS  USED  FOR  THE  DYADIC  CATENATE  FUNCTION, 

THIS  FUNCTION  WILL  COMBINE  TWO  SCALARS  OR  ARRAYS  INTO  A  SINGLE  ARRAY, 
IT  TARES  EITHER  NUMERIC  OR  CHARACTER  ARGUMENTS, 

ENTERING  S1,S2  Wtut  RESULT  IN  A  VECTOR  (SI  SO),  FOR  EXAMPLE' 

Crll2  WILL  ASSIGN  “HE  VECTOR  VALUE  (1  2:  T0  THE  VARIABLE  V, 


VECTORS  CAN  EASILY  BE  EXTENDED  BY  CATENATING  S,V  OR  V, S  OR  V,V, 
FOR  EXAMPLE*  IF  V  =>  \  2  THEN 

v,3  =>  122  0»v  =>  012  v , v  ->  1212 

CATENATING  A  SCALAR  TO  A  MATRIX  WILL  RESULT  IN  A  MATRIX  WITH 

ONE  MORE  COLUMN  THAI!  THE  MATRIX  ARGUMENT,  ALL  ENTRIES  IN  THIS 
COLUMN  WILL  HAVE  "HE  VALUE  OF  THE  SCALAR,  FOR  EXAMPLE  J 

IF  M  =>  1  2  THEN  5,M  =;  512  ®ND  «»5  =>  125 

34  534  345 


CATENATING  TWO  MATRIXES  WILL  RESULT  IN  A  MATRIX  CONTAINING  THE  TWO 
ORIGINAL  MATRIXES  ’SIDE  BY  SIDE', 

BOTH  MATRIXES  MUST  HAVE  THE  SAME  NUMBER  OF  ROWS  OR  A  'LENGTH  ERROR' 


WILL  RESULT, 

FOR  example;  if  mi 


2  AND  M2  =>  56 


THEN  Mi, M2  st 

1  2 

3  4 

5  6 

ftP  h 

M2  ,  Ml 

7  3 

=  > 

5 

6 

1 

O 

3  4 

7  3 

7 

8 

3 

4 

TRYING  TO  CATENATE 

A  VEC 

TOR 

TO  ft 

MATRIX 

WILL 

RESULT 

IN  A  'RANK  ERROR 

THESE  PRINCIPLES  CAN  BE  EXTENDED  TO  HIGHER  LEVEL  ARRAYS, 

FOR  MORE  INFORMATION  OH  DIFFERENT  WAYS  TO  JOIN  ARRAYS,  SEE 
MENU  FOR  LAMINATE, 
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12? 


INDEX  GENERATOR 


HIDE 


,  . .  \  .  .  . . . . 

THE  S'MBOL  \  ( UPSHIFT  I)  IS  USED  FOR  THE  MONADIC  INDEX  GENERATING 

FUNCTION, 

IT  IS  USED  WITH  A  SINGLE  NON-NEGATIVE  INTEGER  ARGUMENT  (SCALAR,  OR 
VECTOR  OF  LENGTH  1), 

IT  RETURNS  A  VECTOR  OF  INTEGERS,  IN  ORDER,  BEGINNING  WITH  THE  IN DEN 
ORIGIN,  AND  ENDING  WITH  THE  ARGUMENT, 

for  example;  (3  =>  123  (0  =>  (an  empty  vector) 

THE  INDEX  ORIGIN  IS  NORMALLY  (BY  DEFAULT)  1, 

USING  \  WITH  A  c.'ON-INTEGERf  NEGATIVE  OR  ARRAY  ARGUMENT  WILL  PRODUCE  A 
'DOMAIN  ERROR', 
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i  Ji 


REDUCTION 


THE  SYMBOL  /  IS  USED  FOLLOWING  ANOTHER  FUHCTIOH  SYMBOL  AND 
F'RECED!  M  >3  A  SIHGlE  ARGUMENT  TO  PRODUCE  THE  MI  XED  FUHCTIOH 
CALLED  reduction, 

REDUCT  I OM  MAY  BE  USED  WITH  NUMERIC  ARGUMENTS  OF  AIM  RANK, 

REDUCTION  MAT  ALSO  BE  USED  WITH  CHARACTER  ARGUMENTS  IF  THE  FUNCTION 

IT  IS  BEING  COMBINED  WITH  ACCEPTS  CHARACTER  ARGUMENTS, 

USING  /  WITH  A  SCALAR  SIMPLY  RETURNS  THE  SCALAR, 

WHEN  USED  W I T  H  A  VECTOR,  REDUCTION  GIVES  THE  SAME  EFFECT  AS  INSERTS 
THE  OTHER  FUNCTION  SYMBOL  BETWEEN  EACH  VALUE  OF  THE  VECTOR, 

FOR  c  X  A  M  P  L  E  ; 

+  /'.  i  2  3)  =;  6  BECAUSE  14-2^3  -i  6 

x /  ( 2  3  1)  =>  21  because  2 x 2 z  4  =;•  24 

WHEN  USING  REDUCTION,  ALWAYS  REMEMBER  Art.  READS  RIGHT  TO  LEFT * 

-/(l  2  3)  =>  2  because  l-(2-3)  =>  2 

-.NOTICE  THIS  PRODUCES  "HE  S-FECT  CF  SUMMATION  WITH  ALTERNATING  SIGN 

WHEN  USED  WITH  A  MhTRIN,  /  WILL  PERFORM  AS  IF  EACH  COLUMN  IS 

A  UNI",  IT  WILL  ADD  THE  CORRESPONDING  ELEMENTS  OF  EACH  COLUMN, 
SO  THAT  THE  ANSWER  WILL  BE  A  VECTOR  WITH  AS  MANY  ELEMENTS  AS 
"HERE  WERE  ROWS  IN  THE  ARGUMENT, 

for  example;  if  f m  = ,  24  then  r+/m  =>  2 

APL  USERS  REFER  TO  THIS  AS  WORKING  'ACROSS'  OR  'OVER’  THE  COLUMNS, 
SINCE  COLUMNS  ARE  THE  SECOND  OF  TWO  DIMENSIONS  OF  A  MATRIX, 

THIS  MEANS  THAT  THE  SYMBOL  /  WORKS  'OVER'  THE  LOST  DIMENSION, 

TO  REDUCE  OVER  THE  FIRST  DIMENSION  (£,G.  ROWS  OF  A  MATRIX),  USE  THE 
SiMBOL  f  VALT  /),  III  PLACE  OF  /, 

THIS  IS  IMPORTANT  WHEN  WORKING  WITH  H I GHE R -D I  MENS  I  ON AL  ARRAYS, 

FOR  EXAMPLE,  IN  A  THREE -DIMENSION*!.  ARRAY  OF  'AGES,  ROWS,  AND 
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COLUMNS,  /  WILL  :  EDUCE  OVER  THE  COLUMNS,  /  OVER  THE  PAGES, 

TO  REDUCE  OVER  AH r  D I  MENS  I Of* ,  YOU  MAY  SPECIFY  The  DIMENSION  I  ft 
■RWCKETS  TQl.wOW  I M6  THE  /  (C’R  THE  /)  SYMBOL, 

FOR  EXAMPLE,  TO  PLUS  REDUCE  OVER  THE  ROWE  OF  A  THREE-DIMENSIONAL 
AIYRA-  CALLED  AA,  ENTER  +/C23aft  OR  +/£23Aft.  T  0  PLUS  REDUCE 
OVER  THE  PAGES,  ENTER  +  /AA  OR  r/[13»A,  TO  PLUS  REDUCE  OVER 
THE  COLUMNS,  ENTER  +  /AA  OF  +/[3]AA, 

THE  SHAPE  OF  THE  AHS'HER  '4  ILL  ALWAYS  BE  THE  SAME  AS  THE  SHAFE  OF  TH 
ARGUMENT  OMITTING  ThE  DIMENSION  REDUCED  OVER, 

for  example;  if  ca  345 

THEN  f+, A  =;  3  A  f+/C2jO  =>  3  5  P+/a  R.  j  5 
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REDUCTION 


FED 


. . . . . .  r  .  . . . . . . . . 

THE  SYMBOL  /  ( JL  T  /  ;•  IE  USED  FOLLOWING  ANOTHER  FUNCTION  S  YMBOL  AND 

PRECEDING  A  SINGLE  ARGUMENT  TO  PRODUCE  THE  MIXED  FUNCTION 
CALLED  REDUCTION, 

REDUCTION  HAY  BE  USED  WITH  NUMERIC  ARGUMENTS  OF  ANY  RANK, 

REDUCTION  MAY  ALSO  BE  USED  WITH  CHARACTER  ARGUMENTS  IF  THE  FUNCTION 
I ”  IS  BEING  COMBINED  WITH  ACCENTS  CHARACTER  ARGUMENTS, 

USING  f  WITH  A  SCALAR  SIMPLY  RETURNS  THE  SCALAR, 

WHEN  USED  WITH  A  VECTOR,  REDUCTION  GIVES  THE  SAME  EFFECT  AS  INSERTING 
THE  OTHER  FUNCTION  SYMBOL  BETWEEN  EACH  VALUE  OF  THE  VECTOR, 

FOR  example; 

+/;i  2  3)  =  >  A  because  1-2+2  -■  6 

x,m2  2  4)  ->  24  because  2*3*4  ->  24 

WHEN  USING  REDUCTION,  ALWA'S  REMEMBER  Art  READS  RIGHT  TO  LEFT; 

-Ml  2  3  5  =>  2  EfCause  i-<2-35  =  >  2 

f  NOTICE  THIS  PRODUCES  THE  EFFECT  OF  SUMMATION  WITH  ALTERNATING  SIGNS, 

WHEN  USED  WITH  A  MATRIX,  f  WILL  PERFORM  AS  IF  EACH  ROW  IS 

A  UNIT,  IT  WILL  ADD  THE  CORRESPONDING  ELEMENTS  OF  EACH  ROW, 

SO  THAT  THE  ANSWER  WILL  BE  A  VECTOR  WITH  AS  MANY  ELEMENTS  AS 
THERE  WERE  COLUMNS  IN  THE  ARGUMENT, 

fir  enamfle;  if  j m  =>  2  4  then  ,+r. m  ->  4 

A  F  L  USERS  REFER  TO  THIS  AS  WORKING  'ACROSS'  OR  'OVER'  THE  ROWS, 

SINCE  ROWS  ARE  the  FIRST  OF  TWO  DIMENSIONS  OF  A  MATRIX, 

THIS  MEANS  THAT  THE  SYMBOL  w  WORKS  'OVER'  THE  FIRST  DIMENSION, 

TO  REDUCE  OVER  THE  LAST  DIMENSION  ( E , G ,  COLUMNS  OF  A  MATRIX).  USE  THE 
SYMBOL  /  IN  PLACE  OF  /, 

THIS  IS  IMPORTANT  WHEN  WORKING  WITH  H I GHE* - D I MENS  I OMOL  ARRAYS, 

FOR  EXAMPLE,  IN  A  THE  EE - D I  ME NS  I  ON Al  ARRAY  OF  FACES,  ROWS,  AND 
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COLUMNS  ,  /  WILL  REDUCE  OVER  THE  COLUMNS,  /  OVER  THE  RAGES 


TO  REDUCE  OVER  ANT  DIMENSION,  YOU  MAT  SPECIFY  THE  DIMENSION  IN 
, TRAC  JETS  FOLLOWING  THE  /  (OR  THE  /)  SYMBOL, 

FOR  EXAMPLE,  TO  PLUS  REDUCE  OVER  THE  ROWS  OF  A  THREE-DIMENSIONAL 
ARRAY  CALLED  AA,  ENTER  +/C23ftA  oft  +/C23Aft.  TO  PLUS  REDUCE 
OVER  THE  PAGES,  ENTER  +/AA  OR  +/£1}AA,  TO  PLUS  REDUCE  OVER 
THE  COLUMNS,  ENTER  +  /AA  DR  +/[3]AA, 

THE  SHAPE  OF  THE  ANSWER  WILL  ALWAYS  BE  THE  SAME  AS  THE  SHAPE  OF  THE 
ARGUMENT  OMITTING  THE  DIMENSION  REDUCED  OVER, 

FOR  EXAMPLE*  IF  fA  =>  3^5 

then  P+/A  s>  4  5  f +/C23A  =>  35  f+/A  =>  34 
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EXPONENTIAL 


EXPO 


. . .  *  . . . . . . 

THE  SYMBOL  *  (UPSHIFT  P)  IS  USEI<  FOP  THE  MONADIC  EXPONENT  I AL  FUNCTION, 

IT  RETURNS  THE  VALUE  OF  THE  CONSTANT  E  TO  THE  POWER  OF  THE  ARGUMENT, 

IT  TAKES  NUMERIC  ARGUMENTS  OF  ANY  RANK, 

for  example;  *o  =>  1  *1  =>  2.718281823 

*.5  =)  1.648721271 

*  (3  “2)  =>  20.08553692  .1253352832 
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POWER 


F  OWE 


. . . . .  t  . . . . . 

THE  SYMBOL  *  ( UPSHIFT  P)  IS  USED  FOR  THE  DYADIC  POWER  FUNCTION, 

THIS  RETURNS  THE  VALUE(S)  OF  THE  LEFT  ARGUMENT  RAISE!'  TO  THE  POWER  OF 
RIGHT  ARGUMENT,  ARGUMENTS  ARE  NUMERIC  OF  ANY  RANK, 

A  N0H-INTE6ER  RIGHT  ARGUMENT  CAN  BE  USED  TO  OBTAIN  ROOTS, 

FOR  example;  2*2  =  >  8  3*0  =  >  1  4* . 5  =>  2 

TO  RAISE  EACH  ELEMENT  OF  A  VECTOR  TO  THE  SAME  POWER,  ENTER  V*P, 

TO  RAISE  A  SCALAR  TO  A  SERIES  OF  POWERS  REPRESENTED  BY  A  VECTOR, 

ENTER  S*V, 

V1*V2  RESULTS  IN  THE  ELEMENTS  OF  VI  BEING  RAISED  TO  THE  POWER  OF 
THE  CORRESPONDING  ELEMENT  IN  V2, 

VI  AND  V2  MUST  HAVE  THE  SAME  NUMBER  OF  ELEMENTS  OR  A  ‘LENGTH  ERROR1 
WILL  RESULT, 

FOR  EXAMPLE*  3*<1  2  3)  3  9  27  (1  2  3)*3  =  >  1  8  27 

(2  3  4) * (5  4  3)  =>  32  81  64 

TO  RAISE  EACH  ELEMENT  OF  THE  MATRIX  M  TO  THE  SAME  POWER  S, 

ENTER  M»S,  TO  RAISE  THE  SCALAR  S  TO  THE  POWER  OF  EACH  ELEMENT 
IN  THE  MATRIX  M,  ENTER  S*M, 

THE  RESULT  WILL  BE  A  MATRIX  THE  SAME  SHAPE  AS  M, 

for  example;  if  m  s)  i  2  then  3**  =>3  9  and  **3  =>18 

34  27  81  27  64 

M1*M2  RESULTS  IN  THE  ELEMENTS  OF  Ml  RAISED  TO  THE  POWER 
OF  THE  CORRESPONDING  ELEMENT  IN  M2, 

FOR  EXAMPLE*  IF  >*l  l  2  **»  ^2  =>  4  3  THEN  *1**2  =>18 

3  4  2  1  9  4 

IF  Ml  AND  M2  arc  NOT  THC  SAME  SHAPE,  A  ‘LENGTH  ERROR1  WILL  OCCUR, 

IF  ONE  ARGUMENT  IS  A  VECTOR  WHILE  THE  OTHER  ARGUMENT  IS  A  MATRIX, 

THE  RESULT  WILL  BE  A  ‘RANK  ERROR', 

THESE  PRINCIPLES  CAM  BE  EXTENDED  TO  HIGHER  LEVEL  ARRATS, 
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143  NATURAL.,  LOG  HATU 

.  ■  . . . . 

THE  SYMBOL  %  (ALT  3)  IS  USED  FOR  THE  MONADIC  NATURAL  LOG  FUNCTION, 

IT  RETURHS  THE  VALUE  OF  THE  FOWER  TO  WHICH  THE  CONSTANT  E  MUST 
BE  RAISE!'  TO  EQUAL  THE  ARGUMENT,  IN  OTHER  WORDS,  ENTERING 
■S  WILL  SOLVE  THE  ARL  EQUATION  *N  =  S  FOR  M, 

IT  TAKES  ONLY  POSITIVE  NUMERIC  ARGUMENTS  OF  ANT  RANK,  USING  •  WITH 
ZERO  OR  WITH  NEGATIVE  ARGUMENTS  WILL  RESULT  IN  A  'DOMAIN  ERROR', 
FOR  EXAMPLE*  »i  =>  0  •2.718231S28  =>  1 

*1.643721271  =>  0.5 

FOR  example:  #(3  2)  =>  1.098612289  0.6931471806 
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LOGARITHM 


LOGA 


. . .  ■  . . . . 

THE  SYMBOL  ■  (ALT  8)  IS  USED  FOR  THE  DYADIC  LOGARITHM  FUHCTION, 

THIS  RETURNS  THE  LOGARITHM  OF  THE  RIGHT  ARGUMENT  IN  THE  BASE  OF  THE 
LEFT  ARGUMENT,  THAT  15,  IT  RETURNS  THE  VALUE  OF  THE  POWER  TO 
WHICH  THE  LEFT  ARGUMENT  MUST  BE  RAISED  TO  EQUAL  THE  RIGHT  ARGUMENT, 

ENTER  L*R  TO  SOLVE  THE  EQUATION  L*N  =  R  FOR  N, 

ARGUMENTS  ARE  POSITIVE  NUMERIC  OF  ANY  RANK,  USING  •  WITH  ZERO  OR  WITH 
NEGATIVE  NUMBERS  WILL  RESULT  IN  A  ‘DOMAIN  ERROR',  ENTERING  1#S 
WHERE  S  IS  ANY  NUMBER  EXCEPT  1  WILL  ALSO  PRODUCE  A  'DOMAIN  ERROR', 

FOR  example;  10*100  =>  2  2»1024  =>  10  9«1  =  >  0 

TO  OBTAIN  THE  LOG  OF  EACH  ELEMENT  OF  A  VECTOR  IN  THE  SAME  BASE, 

ENTER  B*V, 

TO  DETERMINE  THE  LOG  OF  A  SCALAR  IN  A  VECTOR  OF  DIFFERENT  BASES, 

ENTER  V#S, 

V1«V2  RESULTS  IN  THE  LOG  OF  EACH  ELEMENT  IN  V2  IN  THE  BASE  OF 
THE  CORRESPONDING  ELEMENT  IN  VI, 

VI  AND  V2  MUST  HAVE  THE  SAME  NUMBER  OF  ELEMENTS  OR  A  ' LEHGTH  ERROR' 
WILL  RESULT, 

FOR  example;  3»<3  9  27)  =>123  (2  4)916  =>  42 

(2  3  5)«(4  9  25)  -)  222 

ANALOGOUS  RESULTS  ARE  OBTAINED  FOR  MATRIXES  AHD  HIGHER  LEVEL  ARRAYS, 

UNLESSS  ONE  ARGUMENT  IS  A  SCALAR,  BOTH  ARGUMENTS  MUST  BE  THE  SAME 
SHAPE,  OTHERWISE,  A  'RANK  ERROR'  OR  'LENGTH  ERROR'  WILL  RESULT, 


THE  STMDQL  0  (UPSHIFT  0)  IS  USED  FOP:  THE  MONADIC  PI  TIMES  FUNCTION 
IT  RETURNS  THE  VALUE  OF  THE  CONSTANT  PI  TIMES  THE  ARGUMENT, 


IT  TAKES  NUMERIC  ARGUMENTS  OF  AMT  RANK, 

FOR  EXAMPLE*  0 Q  =>  0  01  =>  3. 


0.5  =>  1 . 570796327 

0(3  “25  =  >  9 . 424777961  "6. 


ini 


141592654 

283135307 
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GEOMETRIC 


GEOM 


. . .  Q  . . . 

THE  SYMBOL  a  (UPSHIFT  0)  IS  USES  FOR  THE  DYADIC  GEOMETRIC  FUNCTIONS, 
THESE  INCLUDE  THE  MAIH  TRI G I HOMETR I C  FUHCTIOHS,  THE  LEFT  ARGUMENT, 
WHICH  MUST  BE  AH  INTEGER  FROM  “7  TO  7,  DETERMINES  WHICH  FUNCTION 
IS  CALLED,  THE  RIGHT  ARGUMENT,  WHICH  CAN  BE  A  NUMERIC  ARRAY  OF 
ANY  RANK,  REPRESENTS  THE  VALUE  OF  AN  ANGLE  IN  RADIANS, 

THE  FOLLOWING  FUNCTIONS  ARE  REPRESENTED* 


Q0» 

=  > 

COS  (ARCSIH  Y)  OR 

SIN  (ARCCOS  Y)  WHERE  |Y|<1 

laY 

=  > 

SIN  Y 

“10Y 

=  ) 

ARCSIH  Y  WHERE  |Y  |  <  J 

20  t 

=  > 

COS  Y 

"20Y 

s  V 

ARCCOS  Y  WHERE  |Y|<1 

3  o'1' 

=  > 

TAN  Y 

~3oY 

=:  > 

ARCTAH  Y 

40  »' 

=  > 

COSH  ( ARCSINH  Y) 

“40Y 

2  > 

SIHH  (ARCCOSH  Y)  WHERE  |Y|>; 

5  o'1' 

-•> 

SIHH  Y 

o 

m 

1 

5  > 

ARCSINH  Y 

00'Y 

=  i 

COSH  Y 

"6o» 

*> 

ARCCOSH  Y  WHERE  Y>1 

7av 

=  } 

TANK  Y 

"70Y 

=  > 

ARCTAHH  Y  WHERE  |Y|<1 

OTHER  FUHCTIOHS,  SUCH  AS  SECANT, 

MUST 

COMPUTED  BY  FORMULA, 

FOR  EXAMPLE 

*  (REMEMBER  01  EOUAL 

3  PI 

TIMES  1> 

100 

=  > 

II 

o 

o 

tH 

o 

0 

100.5  =>  1 

2o0 

=  > 

1  2ool  => 

*1 

200.5  =>  1.74393424?e~16 

NOTICE 

THAT 

SOMETIMES  A  VERY  SMALL  HUMBER 

WILL  APPEAR  INSTEAD  OF  ZERO 

OR  A  VERY  LARGE  NUMBER  WILL  APPEAR  INSTEAD  OF  A  DOMAIN  ERROR, 
TECHNICALLY,  THE  TANGENT  OF  OHE -HALF  PI  DOES  NOT  EXIST,  BUT* 

3QQ.5  =>  5.734161139^15  ««tch  out  for  this; 
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FACTORIAL 


FACT 


THE  SYMBOL  J  (ALT  +)  IS  USED  FOR  THE  MONADIC  FACTORIAL  FUNCTION, 

IT  RETURHS  THE  FACTORIAL  OF  WON-NEGATIVE  NUMERIC  ARGUMENTS  OF  ANY  RANK, 
FOR  example;  il  3  0  =>  161 

USING  NON-INTEGER  ARGUMENTS  PRODUCES  THE  GAMMA  FUNCTION  OF  THE 
ARGUMEHT+1 , 

FOR  example;  j.5  =  :  .8862269255  (gamma  of  1,5) 
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BINOMIAL 


BINO 


THE  SYMBOL  ‘  (ALT  +)  IS  USED  FOR  THE  DYADIC  BINOMIAL  FOHCTIOM, 

IT  TAKES  NUMERIC  ARGUMENTS  OF  AHT  RANK. 

FOR  POSITIVE  INTEGER  ARGUMENTS,  L  J R  WILL  RETURN  THE  NUMBER  OF  WAYS  OF 
TAKING  R  OBJECTS  L  AT  A  TIME, 

THIS  IS  THE  BINOMIAL  COEFFICIENT  OF  R  OVER  L,  COMPUTED  ( JR)rJLxJ ( R-L )  , 
WITH  NEGATIVE  OR  NON-INTEGER  ARGUMENTS,  THE  BINOMIAL  FUNCTION  RETURNS 
A  VALUE  BASED  ON  THE  BETA  FUNCTION, 

FOR  EXAMPLE  J  3(4  =>4  BUT  4i3  =>  0 

BECAUSE  THERE  ARE  FOUR  WAYS  OF  TAKING  FOUR  OBJECTS  THREE  AT  A  TIME, 
BUT  THERE  IS  NO  WAY  TO  TAKE  THREE  OBJECTS  FOUR  AT  A  TIME, 

THESE  AHSWERS  ARE  BASED  ON  CONVENTION; 

0J0  =>  1  0  5  42  =  >  1  42 i 42  =>  1 

WHEN  A  SCALAR  ARGUMENT  IS  FAIRED  WITH  A  VECTOR  AR6UMEHT,  THE  FUNCTION 
COMBINES  THE  SCALAR  WITH  EACH  ELEMENT  OF  THE  VECTOR  IN  TURN, 

21 (3  45)  =>  3  o  10  (34  5)15  =  >  10  5  1 

CORRESPONDING  ELEMENTS  OF  TWO  VECTOR  ARGUMENTS  ARE  COMBIHED, 

(3  4  5) i (5  6  7)  =  >  10  15  21 

VI  ANP  V2  MUST  HAVE  THE  SAME  NUMBER  OF  ELEMENTS  OR  A  'LENGTH  ERROR* 
WILL  RESULT, 

WHEN  A  SCALAR  ARGUMENT  IS  PAIRED  WITH  A  MATRIX  ARGUMENT,  THE  FUNCTION 
COMBINES  THE  SCALAR  WITH  EACH  ELEMENT  OF  THE  MATRIX  IN  TURN, 

for  example;  if  m  =>  12  them  3iM  =>  00  and  *J3  =>33 

3  4  14  10 

CORRESPONDING  ELEMENTS  OF  TWO  MATRIX  ARGUMENTS  ARE  COMBINED, 

for  example;  if  m;  si  i  2  and  m2  r>  3  4  them  mi;m2  =>  3  & 

34  56  10  15 

IF  Ml  AMD  M2  ARE  NOT  THE  SAME  SHAPE,  A  'LENGTH  ERROR'  WILL  OCCUR, 

IF  ONE  ARGUMENT  IS  A  VECTOR  WHILE  THE  OTHER  ARGUMENT  IS  A  MATRIX, 
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THE  RESULT  WILL  BE  A  'RANK  ERROR 1  , 


THESE  PRINCIPLES  CAN  BE  EXTENDED  TO  HIGHER  LEVEL  ARRAYS, 
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MAGNITUDE 


MAGM 


THE  SYMBOL  |  (UPSHIFT  H)  IS  USED  FOR  THE  MONADIC  MAGNITUDE  FUMCTIOH, 
IT  RETURNS  THE  ABSOLUTE  VALUE  OF  NUMERIC  ARGUMENTS  OF  ANT  RANK, 

FOR  example:  10  =>  0  !("3  “2  10)  =>  3  2  10 
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SCAN 


3C  A2 


. . .  \  . . . 

THE  SYMBOL  \  (UPSHIFT  /)  IS  USES  FOLLOWING  A  DYADIC  FUNCTION  SlMBOL, 
PRECEDING  A  SINGLE  ARGUMENT  PRODUCING  A  MIXED  FUNCTION  CALLED  SCAN, 
SCAN  MAY  BE  USED  WITH  NUMERIC  ARGUMENTS  OF  ANY  RANK, 

SCAN  MAY  ALSO  BE  USED  WITH  CHARACTER  ARGUMENTS  IF  THE  FUNCTION  IT  IS 
COMBINED  WITH  ACCEPTS  CHARACTER  ARGUMENTS, 

USING  \  WITH  A  SCALAR  SIMPLY  RETURNS  THE  SCALAR, 

WHEN  USED  WITH  A  VECTOR,  SCAN  GIVES  THE  SAME  EFFECT  AS  INSERTING 
THE  OTHER  FUNCTION  SYMBOL  BETWEEN  EACH  VALUE  OF  THE  VECTOR, 

THEM  OPERATING  PROGRESSIVELY  AS  FOLLOWS* 

THE  FIRST  ELEMENT  OF  THE  ANSWER  WILL  BE  THE  FIRST  ELEMENT  OF  THE 
ARGUMENT,  THE  SECOND  ELEMENT  WILL  BE  THE  RESULT  OF  THE  MAIN 
FUNCTION  OPERATING  ON  THE  FIRST  TWO  ELEMENTS  OF  THE  ARGUMENT, 

THE  THIRD  ELEMENT  OF  THE  ANSWER:  WILL  BE  THE  RESULT  OF  THE  MAIN 
FUNCTION  OPERATING  AS  IN  REDUCTION  OH  THE  FIRST  THREE  ELEMENTS 
OF  THE  ARGUMENT,  AND  SO  OH, 

THE  RESULT  WILL  ALWAYS  BE  THE  SAME  LENGTH  AS  THE  ARGUMENT, 

FOR  example; 

+  \<1  2  3)  =  >  13  6  BECAUSE  1  =.}  1,  1+2  =>  3i  1  +  2+3  =  >  6 

x\i2  3  4)  =:>  2  6  24 

WHEN  USING  SCAN,  ALWAYS  REMEMBER  APL  READS  RIGHT  TO  LEFT  WHEN  IT  IS 
USING  REDUCTION  OH  MORE  THAN  TWO  ELEMENTS  OF  THE  ARGUMENT, 

-\U  2  3)  =>  1  "1  2  because  i  =>  i,  1-2  =>  “l,  l-< 2-3)  =>  2 

WHEN  USED  WITH  A  MATRIX,  SCAH  WILL  PERFORM  AS  IF  EACH  COLUMN  IS 

A  UNIT,  THE  FIRST  COLUMH  OF  THE  ANSWER  IS  THE  FIRST  COLUMN  OF 
THE  ARGUMENT,  THE  SECOND  COLUMN  OF  THE  ANSWER  IS  THE  RESULT  OF 
OPERATING  OH  THE  FIRST  TWO  COLUMNS  OF  THE  ARGUMENT,  AND  SO  OH, 

APL  USERS  REFER  TO  THIS  AS  WORKING  'ACROSS*  OR  'OVER*  THE  COLUMNS. 
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I 


SINCE  COLUMNS  ARE  THE  SECOND  OF  TWO  DIMENSIONS  OF  ft  MATRIX, 

THIS  MEANS  THAT  THE  SYMBOL  \  WORKS  'OVER'  THE  LAST  DIMENSION, 

TO  SCAN  OVER  THE  FIRST  DIMENSION  (E.G,  ROWS  OF  A  MATRIX),  USE  THE 
SYMBOL  V  (ALT  .),  IN  PLACE  OF  \, 

THIS  IS  IMPORTANT  WHEN  WORKING  WITH  HIGHER-DIMENSIONAL  ARRAYS, 

FOR  EXAMPLE,  IN  A  THREE-DIMENSIONAL  ARRAY  OF  RAGES,  ROWS,  AND 
COLUMNS,  \  WILL  SCAN  OVER  THE  COLUMNS,  \  OVER  THE  PAGES, 

TO  SCAN  OVER  ANY  DIMENSION,  >OU  MAY  SPECIFY  THE  DIMENSION  IN 
BRACKETS  FOLLOWING  THE  \  (OR  THE  \ >  SYMBOL, 

FOR  EXAMPLE,  TO  PLUS  SCAN  OVER  THE  ROWS  OF  A  THREE-DIMENSIONAL 
ARRAY  CALLED  AA,  ENTER  +\[23ftA  0R  +v.C2]fifl.  T0  PLUS  SCAN  OVER 
THE  PAGES,  ENTER  +  \AA  OR  TO  PLUS  SCAN  OVER  THE  COLUMNS, 

ENTER  +\AA  OR 

THE  RESULT  WILL  ALWAYS  BE  THE  SAME  SHAPE  AS  THE  ARGUMENT, 
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SCAN 


5CA1 


.  . . . 

THE  SYMBOL  \  (ALT  ,)  IS  USED  FOLLOWING  A  DYADIC  FUNCTION  SYMBOL  AMD 

PRECEDING  A  SINGLE  ARGUMENT  PRODUCING  A  MIMED  FUNCTION  CALLED  SCAN, 
SCAN  MAY  BE  USED  WITH  NUMERIC  ARGUMENTS  OF  ANY  RANK, 

SCAM  MAY  ALSO  BE  USED  WITH  CHARACTER  ARGUMENTS  IF  THE  FUNCTION  IT  IS 
COMBINED  WITH  ACCEPTS  CHARACTER  ARGUMENTS, 

USING  \  WITH  A  SCALAR  SIMPLY  RETURNS  THE  SCALAR, 

WHEN  USED  WITH  A  VECTOR,  SCAN  GIVES  THE  SAME  EFFECT  AS  INSERTING 
THE  OTHER  FUNCTION  SYMBOL  BETWEEN  EACH  VALUE  OF  THE  VECTOR, 

THEN  OPERATING  PROGRESSIVELY  AS  FOLLOWS; 

THE  FIRST  ELEMENT  OF  THE  ANSWER  WILL  BE  THE  FIRST  ELEMENT  OF  THE 
ARGUMENT,  THE  SECOND  ELEMENT  WILL  BE  THE  RESULT  OF  THE  MAIN 
FUNCTION  OPERATING  ON  THE  FIRST  TWO  ELEMENTS  OF  THE  ARGUMENT, 

THE  THIRD  ELEMENT  OF  THE  ANSWER  WILL  BE  THE  RESULT  OF  THE  MAIN 
FUNCTION  OPERATING  AS  IN  REDUCTION  ON  THE  FIRST  THREE  ELEMENTS 
OF  THE  ARGUMENT,  AMD  50  ON, 

THE  RESULT  WILL  ALWAYS  BE  THE  SAME  LENGTH  AS  THE  ARGUMENT, 

FOR  example; 

+\(1  23)  =>  136  because  i  =>  j,  1+2  =>  3»  1+2+3  =>  6 

x\(2  34)  =>  2  6  24 

WHEN  USING  SCAN,  ALWAYS  REMEMBER  APL  READS  RIGHT  TO  LEFT  WHEN  IT  IS 
USING  REDUCTION  OH  MORE  THAN  TWO  ELEKEHTS  OF  THE  ARGUMENT, 

-Ml  2  3)  =:  1  "1  2  because  1  =>  1,  1-2  =>  ~i,  i-<2-3>  =>  2 

WHEN  USED  WITH  A  MATRIX,  SCAN  WILL  PERFORM  AS  IF  EACH  ROW  IS 
A  UNIT,  THE  FIRST  ROW  OF  THE  ANSWER  IS  THE  FIRST  ROW  OF 

THE  ARGUMENT,  THE  SECOND  ROW  OF  THE  ANSWER  IS  THE  RESULT  OF 

OPERATING  ON  THE  FIRST  TWO  ROWS  OF  THE  ARGUMENT,  AND  SO  ON, 

APL  USERS  REFER  TO  THIS  AS  WORKING  'ACROSS'  OR  'OVER*  THE  ROWS, 
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SINCE  SOWS  ARE  THE  FIRST  OF  TWO  DIMENSIONS  OF  A  MATRIX, 

THIS  MEANS  THAT  THE  SYMBOL  \  WORKS  •OVER'  THE  FIRST  DIMENSION, 

TO  SCAM  OVER  THE  LAST  DIMENSION  (E,6,  COLUMNS  OF  A  MATRIX),  USE 
THE  SYMBOL  \  (UPSHIFT  /),  IN  PLACE  OF  \  , 

THIS  IS  IMPORTANT  WHEN  WORKING  WITH  H I GHER -D I MENS I OHAL  ARRAYS, 

FOR  EXAMPLE,  IN  A  THREE-DIMENSIONAL  ARRAY  OF  FAGES,  ROWS,  AND 
COLUMNS,  \  WILL  SCAN  OVER  THE  COLUMNS,  \  OVER  THE  RAGES. 

TO  SCAN  OVER  ANY  DIMENSION,  YOU  MAI  SPECIFY  THE  DIMENSION  IN 
BRACKETS  FOLLOWING  THE  (OR  THE  \)  SYMBOL, 

FOR  EXAMPLE,  TO  PLUS  SCAN  OVER  THE  ROWS  OF  A  THREE-DIMENSIONAL 
ARRAY  CALLED  AA ,  ENTER  +\C23fla  OR  +\C23ftfl.  TO  PLUS  SCAM  OVER 
THE  PAGES,  ENTER  +\AA  OR  +\[13AA,  TO  PLUS  SCAN  OVER  THE  COLUMN 
ENTER  +\AA  OR  +\C33AA, 

THE  RESULT  WILL  ALWAYS  BE  THE  SAME  SHAPE  AS  THE  ARGUMENT, 


161 


CEIL! MG 


CEIL 


.  r  . . . 

THE  SYMBOL  f  (UPSHIFT  S)  IS  USES  FOR  THE  MONADIC  CEILING  FUNCTION. 
IT  RETURNS  THE  VALUE  OF  NUMERIC  ARGUMENTS  OF  ANY  RANK,  ‘ROUNDED  UP  1 
TO  THE  NEAREST  INTEGER, 

for  EXAMPLE*  T<"3.4  0  1.3  2)  =>  '3022 
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FLOOR 


FLOO 


.  L  . 

THE  SYMBOL  L  ( UPSHIFT  D)  IS  USED  FOR  THE  MONADIC  FLOOR  FUNCTION, 

IT  RETURNS  THE  VALUE  OF  NUMERIC  ARGUMENTS  OF  ANY  RANK,  • ROUNDED  DOWN' 
TO  THE  NEAREST  INTEGER, 

FOR  EXAMPLE •  l<~3.4  0  1.3  2)  =>  "4012 
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1A2 


MAXIMUM 


MAXI 


.  r  . . . 

THE  SYMBOL  T  (UPSHIFT  3)  IS  USES  FOR  THE  DYADIC  MAXIMUM  FUNCTION, 

THIS  RETURNS  THE  MAXIMUM  OF  ITS  TWO  ARGUMENTS,  WHICH  ARE  NUMERIC 
OF  ANY  RANK, 

for  example;  2T3  =>  3 

TO  CHECK  A  SCALAR  AGAINST  EACH  ELEMENT  OF  A  VECTOR,  ENTER  S|"V  OR  VfS, 
VITV'2  WILL  COMPARE  TWO  VECTORS  ELEMENT  BY  ELEMENT,  FOR  EXAMPLE* 

4T(3  4  5)  =1  4  4  5  (3  4  5 > T 5  =>  5  5  5 

(3  4  5) T ( 1  59)  =>  359 

IF  THE  TWO  VECTORS  BEING  COMPARED  ARE  NOT  THE  SAME  LENGTH, 

A  'LENGTH  ERROR*  WILL  RESULT, 

MATRIX  COMPARISON  IS  DONE  AS  FOLLOWS,* 

SfM  OR  MfS  WILL  CHECK  THE  SCALAR  S  AGAINST  EACH  ELEMENT  OF 
THE  MATRIX  M , 


FOR  example;  IF  M  =>  1 

2 

THEN 

3r*  => 

3  3 

AND 

«r 3  *>  3 

3 

3 

4 

3  4 

3 

4 

MIT  “2  “ILL  COMPARE  THE 

MATRIXES 

Ml  AND 

M2,  1 

ELEMENT  BY  ELEMENT, 

FOR  EXAMPLE;  IF  Ml  => 

1 

2  AND 

M2  => 

3  4 

THEN 

“ir*2  => 

3 

4 

3 

4 

5  A 

5 

6 

Ml  AND  M2  MUST  BE  THE  SAME  SHAPE  OR  A  'LENGTH  ERROR'  WILL  RESULT, 
TRYING  TO  COMPARE  A  VECTOR  TO  A  MATRIX  WILL  RESULT  IH  A  'RANK  ERROR', 

THESE  PRINCIPLES  CAN  BE  EXTENDED  TO  HIGHER  LEVEL  ARRAYS, 


U3 
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MINIMUM 


MINI 


. . .  L  . . . . . 

THE  SYMBOL  (.  (UPSHIFT  DJ  IS  USED  FOR  THE  DYADIC  MINIMUM  FUNCTION. 

THIS  RETURNS  THE  MINIMUM  OF  ITS  TWO  ARGUMENTS,  WHICH  ARE  NUMERIC 
OF  ANY  RANK, 

for  example;  2L2  =>  2 

TO  CHECK  A  SCALAR  AGAINST  EACH  ELEMENT  OF  A  VECTOR,  ENTER  S(.V  OR  VIS, 
V11_V2  WILL  COMPARE  TWO  VECTORS  ELEMENT  BY  ELEMENT,  FOR  EXAMPLE* 

U (3  4  5>  =>  3  4  4  (34  5)L5  =>  345 

(3  4  5 ) L < 1  5  9)  =>  14  5 

IF  THE  TWO  VECTORS  BEING  COMPARED  ARE  HOT  THE  SAME  LENGTH, 

A  'LENGTH  ERROR'  WILL  RESULT, 

MATRIX  COMPARISON  IS  DONE  AS  FOLLOWS; 

3j.M  OR  MJ.5  WILL  CHECK  THE  SCALAR  S  AGAINST  EACH  ELEMENT  OF 
THE  MATRIX  M, 

for  example;  iR  m  =>  i  2  then  31*  =  >  12  *13  =>12 

3  4  3  3  3  3 

MJL*2  WILL  COMPARE  THE  MATRIXES  MJ  AND  MJ  ,  ELEMENT  BY  ELEMENT, 

for  example;  if  mi  =>  i  2  *2  =>  3  4  then  =>  12 

3  4  5  6  3  4 

Ml  AND  M2  MUST  BE  THE  SAME  SHAPE  OR  A  'LENGTH  ERROR1  WILL  RESULT, 
TRYING  TO  COMPARE  A  VECTOR  TO  A  MATRIX  WILL  RESULT  IN  A  'RANK  ERROR’, 

THESE  PRINCIPLES  CAN  BE  EXTENDED  TO  HIGHER  LEVEL  ARRAYS, 


* 


THE  SYMBOL  |  (UPSHIFT  M)  IS  USES  FOR  THE  DYADIC  RESIDUE  FUNCTION. 

IT  TAXES  NUMERIC  ARGUMENTS  OF  ANY  RANK, 

THE  RESULT  OF  L|R  IS  THE  REMAINDER  WHEN  R  IS  DIVIDED  BY  L,  THIS  IS 
SIMILAR  TO  THE  'MODULO'  FUNCTION  IN  OTHER  COMPUTER  LANGUAGES, 

FOR  EXAMPLE: 

111.24  =>  .24  10 1 “4  =>  2  "4110  =  /  "2 

THE  SIGN  OF  THE  RESULT  IS  ALWAYS  THE  SAME  AS  THE  SIGN  OF  THE  LEFT 

ARGUMENT,  IF  THE  SIGNS  OF  THE  ARGUMENTS  DO  HOT  AGREE,  THE  RESULT 
IS  OBTAINED  BY  ADDING  THE  SMALLER  ARGUMENT  TO  THE  LARGER  ONE 
REPEATEDLY  UNTIL  THE  ABSOLUTE  VALUE  OF  THE  RESULT  IS  LESS  THAN 
THE  ABSOLUTE  VALUE  OF  THE  SMALLER  ARGUMENT, 

WHEN  A  SCALAR  ARGUMENT  IS  PAIRED  WITH  A  VECTOR  ARGUMENT,  THE  FUNCTION 
COMBINES  THE  SCALAR  WITH  EACH  ELEMENT  OF  THE  VECTOR  IN  TURN, 

21(1  2345)  =>  10101  <1234  5)13  *>  01033 

CORRESPONDING  ELEMENTS  OF  TWO  VECTOR  ARGUMENTS  ARE  COMBIHED, 

<1  1.5  2)1(1  23)  =>  0  0.5  1 

VJ  AND  V2  MUST  HAVE  THE  SAME  NUMBER  OF  ELEMENTS  OR  A  'LENGTH  ERROR' 
WILL  RESULT, 

WHEN  A  SCALAR  ARGUMENT  IS  PAIRED  WITH  A  MATRIX  ARGUMENT,  THE  FUHCTION 
COMBINES  THE  SCALAR  WITH  EACH  ELEMENT  OF  THE  MATRIX  IN  TURN , 


FOR  example;  IF  M  =>  1 

2  then  3jm  => 

1 

2  AND  M|3 

=  >  0 

1 

3 

4 

0 

1 

0 

3 

CORRESPONDING  ELEMENTS  OF  TWO  MATRIX  ARGUMENTS  ARE  COMBINED, 

for  example;  if  mi  =>  i  2  and  *2  s>  3  4  then  mi|M2  r>  2  2 

3  4  5  6  2  2 

IF  Ml  AND  M2  ARE  NOT  THE  SAME  SHAPE,  A  'LENGTH  ERROR'  WILL  OCCUR, 

IF  ONE  ARGUMENT  IS  A  VECTOR  WHILE  THE  OTHER  ARGUMENT  IS  A  MATRIX, 


THE  RESULT  WILL  BE  A  1 R A H K  ERROR', 

THESE  PRINCIPLES  CAN  BE  EXTENDED  TO  HIGHER  LEVEL  ARRAYS, 
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loo 


CRAPE  UR 


GRUF 


. .  4  . . . 

THE  SYMBOL  4  (ALT  4)  IS  USED  FOR  THE  MOHADIC  CRAPE  UP  FUNCTION, 
rT  TAKES  A  NUMERIC  VECTOR  ARGUMENT  AMP  RETURNS  A  VECTOR  OF  THE 
INDEXES  OF  THE  ELEMENTS  IN  ORPER  FROM  SMALLEST  TO  LARGEST, 

IN  OTHER  WORDS,  THE  FIRST  ELEMEHT  IN  THE  RESPONSE  IS  THE  INDEX 

OF  THE  SMALLEST  ELEMENT  IN  THE  INPUT,  THE  LAST  ELEMENT  IN  THE 
RESPONSE  IS  THE  INDEX  OF  THE  LARGEST  ELEMEHT  IN  THE  INPUT, 

EQUAL  VALUES  WILL  BE  GRADED  IN  ORDER  FROM  LEFT  TO  RIGHT, 

for  example;  44863  =  >  4132 

BECAUSE  THE  FOURTH  ELEMEHT  OF  THE  INPUT  (3)  IS  THE  SMALLEST,  ETC, 
THIS  CAN  BE  USED  TO  SORT  A  VECTOR  BY  COMBINING  WITH  INDEX  BRACKETS; 

IF  v  =',4  8  6  3  then  V£4V]  =  >  3  4  6  8 

ON  THE  OTHER  HAND,  4*V  WILL  PRODUCE  A  VECTOR  OF  THE  POSITION  NUMBERS 
(RANK  ORDER)  CORRESPONDING  TO  THE  INPUT  VECTOR. 

FOR  example;  4*  4863  =>  2431 

SINCE  4  IS  the  SECOND  SMALLEST  ELEMENT,  g  IS  THE  FOURTH  SMALLEST,  ETC, 


167 


GRADE  DOWN 


GRAD 


,  ,  ,  ,  . .  t  . . . . . 

THE  SYMBOL  f  (ALT  3)  IS  USED  FOR  THE  MONADIC  GRADE  DOWN  FUNCTION, 

IT  TAKES  A  NUMERIC  VECTOR  ARGUMENT  AND  RETURNS  A  VECTOR  OF  THE 
INDEXES  OF  THE  ELEMENTS  IN  ORDER  FROM  LARGEST  TO  SMALLEST, 

IN  OTHER  WORDS,  THE  FIRST  ELEMENT  IN  THE  RESPONSE  IS  THE  INDEX 
OF  THE  LARGEST  ELEMENT  III  THE  INPUT,  THE  LAST  ELEMENT  IN  THE 
RESPONSE  IS  THE  INDEX  OF  THE  SMALLEST  ELEMENT  IN  THE  INPUT. 

EQUAL  VALUES  WILL  BE  GRADED  IN  ORDER  FROM  LEFT  TO  RIGHT, 

FOR  EXAMPLE*  t4863  =>  2314 

BECAUSE  THE  SECOND  ELEMENT  OF  THE  INPUT  (@)  IS  THE  LARGEST,  ETC, 
THIS  CAN  BE  USED  TO  SORT  A  VECTOR  BY  COMBINING  WITH  INDEX  BRACKETS; 

ip  v  =>4363  them  V[*V}  =  >  8643 

ON  THE  OTHER  HAND,  ffV  WILL  PRODUCE  A  VECTOR  OF  THE  POSITION  NUMBERS 
(IN  REVERSE  ORDER)  CORRESPONDING  TO  THE  INPUT  VECTOR, 

FOR  EXAMPLE*  ft  -I  8  6  3  =>  3124 

SINCE  4  IS  THE  THIRD  LARGEST  ELEMENT,  3  IS  THE  LARGEST,  ETC, 


ROLL 


ROLL 
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. ,,,,,,,,.,,,4,4,  ?  . . 

THE  SYMBOL  7  (UPSHIFT  0)  IS  USED  FOR  THE  MONADIC  ROLL  FUNCTION. 

THIS  IS  A  RANDOM  NUMBER  GENERATOR  WHICH  TAKES  POSITIVE  INTEGER 
ARGUMENTS  AND  RETURNS  A  RANDOMLY  SELECTED  INTEGER  UP  TO  THE 
VALUE  OF  THE  ARGUMENT, 

THE  LOWEST  POSSIBLE  VALUE  WHICH  CAN  BE  RETURNED  IS  NORMALLY  (BY 
DEFAULT)  1. 

USING  7  WITH  NEGATIVE  ARGUMENTS  OR  ZERO  PRODUCES  A  'DOMAIN  ERROR', 

for  example;  ?3  =>  either  if  2»  QR  3»  with  equal  probability 

WHEN  USED  WITH  VECTORS,  ROLL  RETURNS  A  VECTOR  WITH  EACH  NUMBER 

SELECTED  RANDOMLY  FROM  THE  RANGE  DETERM INI NED  BY  THE  CORRESPONDING 
VALUE  III  THE  ARGUMENT, 

FOR  example; 

?3  3  3  =>  1  1  2  OR  132  0*  332  oft  213  etc. 

6  SIMULATES  THE  ROLLING  OF  A  PAIR  OF  DICE, 

ROLL  CAN  BE  USED  WITH  MATRIXES  OR  HIGHER  LEVEL  ARRAYS  IN  A  SIMILAR 
FASHION, 
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DEAL 


DEAL 


,,,,,,,, . . .  ?  . . . . 

THE  SYMBOL  ?  (UPSHIFT  0)  IS  USED  FOR  THE  DYADIC  DEAL  FUNCTION, 

THE  RESULT  OF  THIS  FUNCTION  IS  AN  ARRAY  OF  RANDOM  NUMBERS, 

THE  SHAPE  OF  THE  ARRAY  IS  DETERMINED  BY  THE  LEFT  ARGUMENT, 

THE  NUMBERS  ARE  RANDOMLY  SELECTED  FROM  THE  POSITIVE  INTEGERS 
UP  TO  THE  VALUE  OF  THE  RIGHT  ARGUMENT,  WITH  NO  REPLACEMENT, 
THAT  IS,  A  NUMBER  CANNOT  APPEAR  TWICE  IN  THE  RESULT, 

BOTH  ARGUMENTS  MUST  BE  A  POSITIVE  SINGLE  NUMBER  (SCALAR  OR  VECTOR 
OF  LENGTH  ]_)  ,  AND  THE  RIGHT  MUST  EQUAL  OR  EXCEED  THE  LEFT, 
USING  HIGHER -ORDER:  ARGUMENTS  PRODUCES  A  'RANK  ERROR', 

USING  NEGATIVE  ARGUMENTS  OR  ZERO  PRODUCES  A  'DOMAIN  ERROR1, 

FOR  EXAMPLE*  2?2  =  >  12  0ft  2  1  BUT  NOT  2  2  0B:  1  1 

5?52  SIMULATES  THE  DEAL  OF  A  HAND  OF  CARDS, 
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i 


ISO 


EQUAL 


FQUA 


THE  SYMBOL  =  (UPSHIFT  5)  IS  USED  FOR  THE  DYADIC  EQUALS  FUNCTION, 

THIS  COMPARES  NUMERIC  OR  CHARACTER  ARGUMENTS  OF  ANY  RANK, 

IT  RETURNS  1  FOP'  EACH  ELEMENT  OF  THE  LEFT  ARGUMENT  THAT  IS  IDENTICAL 
TO  THE  CORRESPONDING  ELEMENT  OF  THE  RIGHT  ARGUMENT,  AND  0  F0P 
EACH  ELEMENT  THAT  tS  NOT, 

for  example;  2=2  =>  1  2=4  =>  0  • a  1  =  < s 1  =>  o 

TO  COMPARE  A  SCALAR  TO  EACH  ELEMENT  OF  A  VECTOR, 

ENTER  EITHER  S=V  OR  V  =  S, 

2=l2  34)  =>  100  (3  4  5>=5  =>  001 

V1=V2  MILL  COMPARE  TWO  VECTORS  ELEMENT  BY  ELEMENT,  FOR  EXAMPLE; 

1  THINK  1  a  1  THANK  1  a >  110  11 

IF  THE  TWO  VECTORS  BEING  COMPARED  ARE  NOT  THE  SAME  LENGTH, 

YOU  WILL  GET  A  'LENGTH  ERROR*, 

MATRIX  COMPARISON  IS  DONE  AS  FOLLOWS; 

S=M  OR  M=S  WILL  COMPARE  THE  SCALAR  S  TO  EACH  ELEMENT  OF  THE  MATRIX  M, 
FOR  EXAMPLE*,  IF  M  a>  12  THEN  3  =  M  r)  0  0  AHl'  M  =  3  =>0  0 

3  4  10  10 

M1=M2  WILL  COMPARE  THE  MATRIX  Ml  TO  THE  MATRIX  M2,  ELEMENT  BY  ELEMENT, 
FOR  EXAMPLE;  IF  »[  :)  HOW  AND  M2  =>  OOH  THEN  M;  =  M2  =)  010 

HOW  WOW  Oil 

Ml  AND  MH  MUST  BE  THE  SAME  SHAPE  OR  A  'LENGTH  ERROR'  WILL  RESULT, 
COMPARING  A  VECTOR  TO  A  MATRIX  WILL  RESULT  IN  A  'RANK  ERROR', 

THESE  PRINCIPLES  CAN  BE  EXTENDED  TO  HIGHER  LEVEL  ARRAYS, 


181  HOT_£QUAL  MOT  E 

.  *  . . . . 

THE  SYMBOL  *  (UPSHIFT  g)  IS  USED  FOR  THE  DYADIC  HOT  EQUAL  FUNCTION, 
THIS  COMPARES  NUMERIC  OR  CHARACTER  ARGUMENTS  OF  ANY  RANK, 

IT  RETURNS  1  FOR  EACH  ELEMENT  OF  THE  LEFT  ARGUMENT  THAT  IS  HOT  EQUAL 
TO  THE  CORRESPONDING  ELEMENT  OF  THE  RIGHT  ARGUMENT,  AND  0  F0P' 

EACH  ELEMENT  THAT  IS, 

for  e;; ample;  2*2  =•  0  2*4  =>  1  'A'*'**  =>  1 

TO  COMPARE  A  SCALAR  TO  EACH  ELEMENT  OF  A  VECTOR, 

ENTER  EITHER  S;*V  OR  V^S, 

2*<2  3  4)  =>  0  1  1  (34  5) *5  =>  110 

V 1 *  V  H  WILL  COMPARE  TWO  VECTORS  ELEMENT  BY  ELEMENT,  FOR  EXAMPLE' 

•  THINK  1  ;i  ■  THANK  •  =>  0  0  10  0 

IF  THE  TWO  VECTORS  BEING  COMPARED  ARE  NOT  THE  SAME  LENGTH, 

YOU  WILL  GET  A  'LENGTH  ERROR', 

MATRIX  COMPARISON  IS  DONE  AS  FOLLOWS} 

S^M  OR  Mj^S  WILL  COMPARE  THE  SCALAR  S  TO  EACH  ELEMENT  OF  THE  MATRIX  M, 

for  example;  if  m  =>  i  2  then  3*m  =>  11  and  m*3  =>  l  i 

3  4  0  1  0  1 

MljdM2  WILL  COMPARE  THE  MATRIX  Ml  TO  THE  MATRIX  MJ,  ELEMENT  BY  ELEMENT, 
FOR  EXAMPLE*  IF  Ml  =>  HOW  AND  M2  =>  OOH  THEN  MljKMJ  =>  101 

HOW  WOW  100 

Ml  AND  M2  MUST  BE  THE  SAME  SHAPE  OR  A  'LENGTH  ERROR'  WILL  RESULT, 
COMPARING  A  VECTOR  TO  A  MATRIX  WILL  RESULT  IN  A  'RANK  ERROR', 

THESE  PRINCIPLES  CAN  BE  EXTENDED  TO  HIGHER  LEVEL  ARRAYS, 
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LESS  THAN 


LESS 


. . . .  <  . . .  . . . . 

THE  SYMBOL  '  (UPSHIFT  3)  IS  USED  FOR  THE  DYADIC  LESS  THAN  FUNCTION, 
THIS  COMPARES  NUMERIC  ARGUMENTS  OF  ANY  RANK, 

IT  RETURNS  1  FOR  EACH  ELEMENT  OF  THE  LEFT  ARGUMENT  THAT  IS  LESS 

THAN  THE  CORRESPONDING  ELEMENT  OF  THE  RIGHT  ARGUMENT,  AND  0  FOR 
EACH  ELEMENT  THAT  IS  NOT, 

for  example*  2<2  =>  0  2 <4  =>  1 

TO  COMPARE  A  SCALAR  TO  EACH  ELEMENT  OF  A  VECTOR, 

ENTER  EITHER  S  (V  OR  V<S,  ORDER.  IS  IMPORTANT, 

2<  (1  2  3)  =>  0  0  1  (3  4  5)  <5  =>  110 

VI (V2  WILL  COMPARE  TWO  VECTORS  ELEMENT  BY  ELEMENT,  FOR  EXAMPLE* 

(1  2  3 )  <  ( 1  33)  =>  Oil 

IF  THE  TWO  VECTORS  BEING  COMPARED  ARE  NOT  THE  SAME  LENGTH, 

YOU  WILL  GET  A  'LENGTH  ERROR', 

MATRIX  COMPARISON  IS  DONE  AS  FOLLOWS', 

3<M  OR  M<S  WILL  COMPARE  THE  SCALAR  S  TO  EACH  ELEMENT  OF  THE  MATRIX  M, 
FOR  EXAMPLE*  IF  M  =>  J.  2  THEM  3<M  =>  0  0  AND  M<3  =>11 

3  4  0  1  0  0 

M1<M2  WILL  COMPARE  THE  MATRIX  Ml  TO  THE  MATRIX  M2,  ELEMENT  BY  ELEMENT, 
FOR  EXAMPLE*  IF  HJ  s)  1  4  AND  MC  =>  2  6  THEN  M1<M2  =>  11 

4  7  5  3  1  0 

Ml  AND  M2  MUST  BE  THE  SAME  SHAPE  OR  A  'LENGTH  ERROR'  WILL  RESULT, 
COMPARING  A  VECTOR  TO  A  MATRIX  WILL  RESULT  IN  A  'RANK  ERROR', 

THESE  PRINCIPLES  CAN  BE  EXTENDED  TO  HIGHER  LEVEL  ARRAYS, 
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133 


LESS  OR  EQUAL 


LTEQ 


,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,  <  ,,,,,,,,,,,,,,,,, . . . .  . 

THE  SYMBOL  l  (UPSHIFT  4)  IS  USED  FOR  THE  DYADIC  LESS  THAN  OR  EQUAL  TO 

FUNCTION,  THIS  COMPARES  HUMERIC  ARGUMENTS  OF  All  Y  RANK, 

IT  RETURNS  1  eOR  EACH  ELEMENT  OF  THE  LEFT  ARGUMENT  THAT  IS  LESS  THAI.' 

OR  EQUAL  TO  THE  CORRESPONDING  ELEMENT  OF  THE  RIGHT  ARGUMENT,  AND 
0  FOR  EACH  ELEMENT  THAT  IS  NOT, 

for  example;  212  =>  1  214  =>  1  2i"2  =>  0 

TO  COMPARE  A  SCALAR  TO  EACH  ELEMENT  OF  A  VECTOR, 

ENTER  EITHER  Sj,V  OR  V<.S,  ORDER  IS  IMPORTANT, 

21 1 1  2  3)  =>  0  1  1  <34  5)15  =>  111 

>J11V2  WILL  COMPARE  TWO  VECTORS  ELEMENT  BY  ELEMENT,  FOR  EXAMPLE* 

<1  2  3)1(1  35)  =)  111 

IF  THE  TWO  VECTORS  BEING  COMPARED  ARE  MOT  THE  SAME  LENGTH, 

YOU  WILL  GET  A  ‘LENGTH  ERROR', 

MATRIX  COMPARISON  IS  DONE  AS  FOLLOWS* 

Sj.M  OR  M^S  WILL  COMPARE  THE  SCALAR  5  TO  EACH  ELEMENT  OF  THE  MATRIX  M, 
FOR  EXAMPLE;  IF  M  =>  12  then  3<M  =  >  Q  Q  AND  M_<  3  =>11 

3  4  11  10 

M11M2  WILL  COMPARE  THE  MATRIX  M 1  TO  THE  MATRIX  M2,  ELEMENT  BY  ELEMENT, 
FOR  EXAMPLE;  IF  Ml  r>  1  4  AND  M2  =  >  2  6  THEN  M1£M2  =>  11 

4  7  5  3  1  0 

Ml  AND  M2  MUST  BE  THE  SAME  SHAPE  OR  A  'LENGTH  ERROR*  WILL  RESULT, 
COMPARING  A  VECTOR  TO  A  MATRIX  WILL  RESULT  IN  A  'RANK  ERROR', 

THESE  PRINCIPLES  CAN  BE  EXTENDED  TO  HIGHER  LEVEL  ARRAYS, 
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134 


GREATER  OR  EQUAL 


GT£f« 


,,,,,,,,,,,,,,,,,, . ,,,,,  >  . 

THE  SYMBOL  >,  (UPSHIFT  £)  IS  USED  FOR  THE  DYADIC  GREATER  THAI'  OR  EQUAL 
TO  FUNCTION,  THIS  COMPARES  NUMERIC  ARGUMENTS  OF  ANY  RANK, 

IT  RETURNS  J  FOR  EACH  ELEMENT  OF  THE  LEFT  ARGUMENT  THAT  IS  GREATER 
THAN  OR  EQUAL  TO  THE  CORRESPONDING  ELEMENT  OF  THE  RIGHT  ARGUMENT, 
AND  0  F0R  EACH  ELEMENT  THAT  IS  NOT, 

for  emample;  22.2  =  >  1  224  =  >  0  22“2  =>  1 

TO  COMPARE  A  SCALAR  TO  EACH  ELEMENT  OP  A  VECTOR, 

ENTER  EITHER  SW  OR  V^S  ,  ORDER  IS  IMPORTANT, 

22(1  2  3)  =>  1  1  0  (3  4  5>25  =>  0  0  1 

V12>'2  will  COMPARE  TWO  VECTORS  ELEMENT  BY  ELEMENT,  FOR  EXAMPLE  * 

(1  2  3)2(1  35)  =  >  100 

IF  THE  TWO  VECTORS  BEING  COMPARED  ARE  NOT  THE  SAME  LENGTH, 

YOU  WILL  GET  A  'LENGTH  ERROR’, 


MATRIX  COMPARISON  IS  DONE  AS  FOLLOWS 

♦ 

S^M  OR  5  WILL  COMPARE 

THE  SCALAR  s 

TO  EftCH 

ELEMENT  OF  THE 

MATRIX  M, 

for  example;  if  m  =>  i 

2  them  3 

2M 

=  >  l  l 

AND  M23  =  >  0 

0 

3 

4 

1  0 

1 

1 

M12M2  WILL  COMPARE  THE 

MATRIX  Ml 

TO 

THE  MATRIX  M2,  ELEMENT 

BY  ELEMENT 

FOR  EXAMPLE*  IF  Ml  =) 

1  4  AND 

M2 

=  >2  6 

THEH  M12M2  => 

0  0 

4  7 

5  3 

0  1 

Mi  AMD  M2  MUST  BE  THE  SAME  SHAPE 

OR 

A  'LENGTH 

ERROR'  WILL  RESULT, 

COMPARING  A  VECTOR  TO  A  MATRIX  WILL  RESULT  IN  A  'RANK  ERROR', 

THESE  PRINCIPLES  CAN  BE  EXTENDED  TO  HIGHER  LEVEL  ARRAYS, 
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GREATER  THAN 


GREA 


THE  SYMBOL  >  (UPSHIFT  7)  IS  USED  FOR  THE  DYADIC  GREATER  THAN 
FUNCTION,  THIS  COMPARES  NUMERIC  ARGUMENTS  OF  AH  Y  RANK , 

IT  RETURNS  1  FOR  EACH  ELEMENT  OF  THE  LEFT  ARGUMENT  THAT  IS  GREATER 
THAN  THE  CORRESPONDING  ELEMENT  OF  THE  RIGHT  ARGUMENT,  AND  0  r0R 
EACH  ELEMENT  THAT  IS  NOT, 

FOR  EXAMPLE*  2>2  =>  0  4 >2  =>  1 

TO  COMPARE  A  SCALAR  TO  EACH  ELEMENT  OF  A  VECTOR, 

ENTER  EITHER  S)V  OR  V>3,  ORDER  IS  IMPORTANT, 

2X1  2  3)  =>  1  0  0  (3  4  5)  >5  =>  0  0  0 

Vi>V2  WILL  COMPARE  TWO  VECTORS  ELEMENT  BY  ELEMENT,  FOR  EXAMPLE  * 

<1  2  35  X  1  3  5)  =>  0  0  0 

IF  THE  TWO  VECTORS  BEING  COMPARED  ARE  HOT  THE  SAME  LENGTH, 

YOU  WILL  GET  A  'LENGTH  ERROR', 

MATRIX  COMPARISON  IS  DONE  AS  FOLLOWS* 

3  >  M  OR  M'S  WILL  COMPARE  THE  SCALAR  S  TO  EACH  ELEMENT  OF  THE  MATRIX  M, 
FOR  EXAMPLE*  IF  M  =>  J  2  THEN  3>M  =>  11  AND  M>3  =>00 

3  4  0  0  0  1 

M1>M2  WILL  COMPARE  THE  MATRIX  Ml  TO  THE  MATRIX  MR,  ELEMENT  BY  ELEMENT, 
FOR  EXAMPLE*  IF  Ml  =>  1  4  AND  M2  =>  2  6  THEN  M1>M2  =>  00 

4  7  13  11 

Ml  ANP  M2  MUST  BE  THE  SAME  SHAPE  OR  A  'LENGTH  ERROR'  WILL  RESULT, 
COMPARING  A  VECTOR  TO  A  MATRIX  WILL  RESULT  IN  A  1 RAHK  ERROR', 

THESE  PRINCIPLES  CAN  BE  EXTENDED  TO  HIGHER  LEVEL  ARRAYS, 
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HOT 


HOT 


THE  SYMBOL.  .«  (UPSHIFT  T)  IS  USED  FOR  THE  MONADIC  HOT  FUNCTION, 

IT  TAKES  AM  ARGUMENT  OF  ANY  RANK  WHICH  CONSISTS  ONLY  OF  l‘S  AND  Q‘S, 
AND  RETURNS  THE  LOGICAL  INVERSE,  THAT  IS,  i'S  ARE  CHANGED  TO  Q'S 
AMD  0‘S  ARC  CHANGED  TO  I'S, 

for  example;  *1001  *>  0110 
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AND 


a  Hi' 


. . . . .  A  . . . . ,  ,,,,,,, 

THE  SYMBOL  A  (UPSHIFT  0)  IS  USED  FOR  THE  DYADIC  AND  FUHCTIOM, 

IT  TAKES  ARSUMEHTS  OF  AMY  RANK  WHICH  CONSIST  ONLY  OF  J.  •  S  AHD  0'S. 
THIS  FUHCTIOM  RETURNS  \  WHERE  BOTH  AROUMEHTS  ARE  1,  AMD  Q  OTHERWISE, 
THE  ORDER  OF  THE  ARGUMENTS  IS  HOT  IMPORTANT,  BUT  ENTERING  AM  ARGUMENT 
WHICH  IS  MOT  i  OR  Q  WILL  PRODUCE  A  'DOMAIN  ERROR1, 

FOR  EXAMPLE*  1*1  =>  1  1a()  =>  (j  0A0  =>  0 

TO  COMPARE  A  SCALAR  TO  EACH  ELEMENT  OF  AH  ARRAY, 

ENTER  EITHER  SaA  OR  AaS,  FOR  EXAMPLE,  IF  V  =>  2  "3  0 

1MXV)  =  >  10  0  (V=2)  A  vcn=2  =>  10  0 

A1aA2  WILL  COMPARE  TWO  ARRAYS  ELEMENT  BY  ELEMENT,  FOR  EXAMPLE* 

(V>-3)  A  (V<2)  =>  001 

Ie  Ml  =>  1  0  AMD  M2  =>  1  1  THEM  M1aM2  =>  10 

1  0  0  0  0  0 

A 1  AHD  A2  MUST  BE  THE  SAME  SHAPE  OR  A  'LENGTH  ERROR’  WILL  RESULT, 
COMPARING  TWO  ARRAYS  OF  DIFFERENT  RANK,  FOR  EXAMPLE  A  VECTOR  AHD  A 
MATRIX,  WILL  RESULT  IM  A  ’RANK  ERROR1, 
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It  AMD 


II  AMD 


,,,,,,,,,,,,,,,,,,,,, . ,  ,  ,  ,  ,  *  ...................  ,,,,,,,  ,,,,,,,,, 

THE  SYMBOL  *  (ALT  Q)  IS  USED  FOR  THE  DYADIC  MOT  AND  FUNCTION, 

IT  TAKES  ARGUMENTS  OF  AMY  RANK  WHICH  CONSIST  ONLY  OF  I'S  AND  Q'S, 
THIS  FUNCTION  RETURNS  1  WHERE  ONE  Oft  NEITHER  OF  THE  ARGUMENTS  ARE  1, 
AND  0  OTHERWISE  (WHERE  BOTH  ARE  1), 

THE  ORDER  OF  THE  ARGUMENTS  IS  HOT  IMPORTANT,  BUT  ENTERING  AN  ARGUMENT 
WHICH  IS  NOT  1  OR  0  MILL  PRODUCE  A  'DOMAIN  ERROR1, 

FOR  EXAMPLE*.  >1  =>  0  1*0  =>  1  0*0  =>  1 


TO  COMPARE  A  SCALAR:  TO 
ENTER  EITHER  S*A  OR 


EACH  ELEMENT  OF  AN  ARRAY, 

A*  5 ,  FOR  EXAMPLE,  IF  V  => 


2  "3  0 


1MXV)  =>  Oil  <v  =  2)  *  vci>2  =>  Oil 

A1*A2  WILL  COMPARE  TWO  ARRAYS  ELEMENT  BY  ELEMENT,  FOR  EXAMPLE* 

(V>"3)  *  (V<2)  =>  lio 


>  1 

o  AND 

«2  =>  1 

1 

THEN  M1*M2  =>  0 

1 

1 

0 

0 

0 

1 

1 

A 1  AND  A2  MUST  BE  THE  SAME  SHAPE  OR  A  'LENGTH  ERROR1  WILL  RESULT, 
COMPARING  TWO  ARRAYS  OF  DIFFERENT  RANK,  FOR  EXAMPLE  A  VECTOR  AND  A 
MATRIX,  WILL  RESULT  IN  A  'RANK  ERROR1, 
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194 


OR 


OP 


THE  SYMBOL  v  (UPSHIFT  9)  IS  USED  FOR.  THE  DYADIC  OR  FUHCTIOH, 

IT  TAKES  ARGUMENTS  OF  ANY  RANK  WHICH  CONSIST  ONLY  OF  1 ■ S  AND  O' 5, 
THIS  FUNCTION  RETURNS  1  WHERE  ONE  OR  BOTH  ARGUMENTS  ARE  J, 

AND  0  OTHERWISE  (WHERE  BOTH  ARE  0). 

THE  ORDER  OF  THE  ARGUMENTS  IS  NOT  IMPORTANT,  BUT  ENTERING  AN  ARGUMENT 
WHICH  IS  NOT  1  OR  0  WILL  PRODUCE  A  'DOMAIN  ERROR:', 


FOR  EXAMPLE;  Ivl 


lvO 


=  > 


OvO 


TO  COMPARE  A  SCALAR  TO  EACH  ELEMENT  OF  AN  ARRAY, 

ENTER  EITHER  SVA  OR  AVS,  FOR  EXAMPLE,  IF  V  =>  2  *3  0 

lv(XV)  =  >  111  (V  =  2)  V  V[H  =  3  =  >  100 

A1vA2  will  COMPARE  TWO  ARRAYS  ELEMENT  BY  ELEMENT.  FOR  EXAMPLE  J 
(V>~3)  v  (V<2)  =>111 

IF  Ml  =>  1  0  GND  M2  =>  1  1  THEN  MlvM2  =>  11 

1  0  0  0  1  0 


A 1  AND  A2  MUST  BE  THE  SAME  SHAPE  OR  A  'LENGTH  ERROR’  WILL  RESULT, 
COMPARING  TWO  ARRAYS  OF  DIFFERENT  RANK,  FOR  EXAMPLE  A  VECTOR  AND  A 
MATRIX,  WILL  RESULT  IN  A  'RANK  ERROR', 
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195 


WOB. 


MOB: 


THE  STMSOL  v  (ALT  9)  IS  USED  FOR  THE  DYADIC  HOB.  FUNCTION, 

IT  TAKES  ARGUMENTS  OF  ANT  BANK  WHICH  CONSIST  ONLY  OF  1 ' S  AND  0‘s. 
THIS  FUNCTION  RETURNS  1  WHERE  NEITHER  OF  THE  ARGUMENTS  ARE  1, 

AND  0  OTHERWISE, 

THE  ORDER  OF  THE  ARGUMENTS  IS  HOT  IMPORTANT,  BUT  ENTERING  AH  ARGUMENT 
WHICH  IS  HOT  1  OR  0  WILL  PRODUCE  A  'DOMAIN  ERROR1, 

for  example;  =>  0  lvO  =>  0  0*0  =>  1 

TO  COMPARE  A  SCALAR  TO  EACH  ELEMENT  OF  AN  ARRAY, 

ENTER  EITHER  S*A  OR  A*S ,  FOR  EXAMPLE,  IF  V  =>  2  “3  0 

1*(XV)  =  >  000  (V=2>  V  VC 1 3=3  =>  Oil 

A1*AT  WILL  COMPARE  TWO  ARRAYS  ELEMENT  6T  ELEMENT,  FOR  EXAMPLE; 

<V,"3)  *  (V<2)  =>  000 


IP  Ml  =>  1 

o  AMD 

M2  =>  1 

1 

THEN  M\*M2  si 

0 

0 

1 

0 

0 

0 

0 

1 

A 1  AND  A2  MUST  PE  THE  SAME  SHAPE  OR  A  'LENGTH  ERROR’  WILL  RESULT, 
COMPARING  TWO  ARRAYS  OF  DIFFERENT  RANK,  FOR  EXAMPLE  A  VECTOR  AND  A 
MATRIX,  WILL  RESULT  IN  A  'RANK  ERROR*, 
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MEMBER  OF 


MEMP 


. . . .  £  . 

THE  SYMBOL  £  ( UPSHIFT  E)  IS  USED  FOR  THE  DYADIC  MEMBER  OF  FUNCTION, 

THIS  COMPARES  HUMERI C  OP  CHARACTER  ARGUMENTS  OF  AMY  RANK, 

IT  RETURNS  1  rOR  EACH  ELEMENT  OF  THE  LEFT  ARGUMENT  THAT  IS  FOUND 
ANYWHERE  IN  THE  RIGHT  ARGUMENT,  AMD  0  FOR  EVERY  ELEMENT 
THAT  IS  MOT, 

WITH  TWO  SCALAR  ARGUMENTS,  £  IS  EQUIVALENT  TO  =  , 

for  example;  2i2  =  >  1  =>  0  'A'£'B‘  =>  o 

TO  DETERMINE  IF  A  SCALAR  IS  A  MEMBER  OF  AH  ARRAY,  ENTER  S£A, 

2£ (2  3  4)  =>  1  '»■ i 'flSC-  =>  1 

ENTERING  A£S  WILL  PRODUCE  THE  SAME  RESULT  AS  A  =  S  , 

A1£A2  WILL  TAKE  EACH  ELEMENT  OF  THE  LEFT  ARRAY  AND  DETERMINE  IF 
IT  IS  CONTAINED  IN  THE  RIGHT  ARRAY, 

FOR  example;  'WHICH  l 1  £ '0123456789'  =  >  0  0  0  0  0  0  1 

IF  A1  =>  1  22  14  and  02  =>  123 

33  5  2 

THEN  A1£A2  =>  100  AND  «2f01  =  >  110 

0  0  1 

THE  RESULT  OF  A^£A2  HAS  THE  SAME  SHAPE  AS  A  2 , 
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201 


REVERSE 


R  E  V  2 


.  «  . . . 

THE  SYMBOL  $  ( ALT  5)  IS  USE!'  FOR  THE  MONADI C  REVERSE  FUNCTION, 

IT  TAKES  NUMERIC  OR  CHARACTER  ARGUMENTS  OF  ANY  RANK, 

IT  RETURNS  ALL  THE  ELEMENTS  OF  THE  ARGUMENT  IN  THE  SAME  SHARE, 

BUT  IN  A  DIFFERENT  ORDER,  AS  FOLLOWS, 

USING  ®  WITH  A  SCALAR  SIMPLY  RETURNS  THE  SCALAR, 

USING  $  WITH  A  VECTOR  RETURNS  THE  VECTOR  IN  REVERSE  ORDER, 

FOR  example;  $235  =>  532 

$  1  STOP  1  =)  POTS 

WHEN  USED  WITH  A  MATRIX,  .}  TAKES  THE  COLUMNS  AS  UNITS  AND  REVERSES 
THEM,  THE  FIRST  COLUMN  BECOMES  THE  LAST  COLUMN,  AND  SO  ON, 

FOR  EXAMPLE,  IF  M  =)  123  THEM  $M  =>  321 

4  5  6  6  5  4 

7  8  9  9  8  7 

AFL  U5EPS  REFER  TO  THIS  AS  WORKING  'ACROSS'  OR  'OVER'  THE  COLUMNS, 
SINCE  COLUMNS  ARE  THE  SECOND  OF  TWO  DIMENSIONS  OF  A  MATRIX, 

THIS  MEANS  THAT  THE  SYMBOL  $  WORKS  'OVER'  THE  LAST  DIMENSION, 

TO  REVERSE  OVER  THE  FIRST  DIMENSION  <E,G,  ROWS  OF  A  MATRIX),  USE  THE 
SYMBOL  a  ( ALT  7),  IN  PLACE  OF  |, 

THIS  IS  IMPORTANT  WHEN  WORKING  WITH  H I GHER -D I MEH5 1  ON AL  ARRAYS, 

FOR  EXAMPLE,  IN  A  THREE-DIMEMS IOHAL  ARRAY  OF  PAGES,  ROWS,  AND 
COLUMNS,  $  WILL  REVERSE  OVER  THE  COLUMNS,  a  OVER  THE  PAGES, 

TO  REVERSE  OVER  ANY  DIMENSION,  YOU  MAY  SPECIFY  THE  DIMENSION  IN 
BRACKETS  FOLLOWING  THE  $  (OR  THE  a)  SYMBOL, 

FOR  EXAMPLE,  TO  REVERSE  OVER  THE  ROWS  OF  A  THREE-DIMENSIONAL  ARRAY 
CALLED  AA,  ENTER  <[2]AA  8[2JAA.  TO  REVERSE  OVER  THE  PAGES, 

EHTER  a A A  OR  $[1]AA,  TO  REVERSE  OVER  THE  COLUMNS,  ENTER  «AA 

OR  aC33AA. 
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REVERSE 


REV1 


. . . . .  9  . 

THE  SYMBOL  6  (OUT  7)  IS  US Eli  FOR  THE  MONADIC  REVERSE  FUNCTION, 
IT  TAKES  NUMERIC  OR  CHARACTER  ARGUMENTS  OF  AMY  RANK, 

IT  RETURNS  ALL  THE  ELEMENTS  OF  THE  ARGUMENT  IN  THE  SAME  SHAPE, 
BUT  IN  A  DIFFERENT  ORDER,  AS  FOLLOWS, 

USING  g  WITH  A  SCALAR  SIMPLY  RETURNS  THE  SCALAR, 

USING  9  WITH  A  VECTOR  RETURNS  THE  VECTOR  IN  REVERSE  ORDER, 

FOR  example  *  62  3  5  =>  5  3  2 

a'STOpi  =>  POTS 

WHEN  USED  WITH  A  MATRIX,  a  TAKES  THE  ROWS  AS  UNITS  AND  REVERSES 
THEM,  THE  FIRST  ROW  BECOMES  THE  LAST  ROW,  AND  SO  ON, 


FOR  EXAMPLE,  IF  M  =>  \ 

i- 

3 

THEN 

9M 

2  > 

7 

8 

9 

4 

5 

6 

4 

5 

6 

7 

s 

9 

1 

2 

3 

APL  USERS  REFER  TO  THIS  AS  WORKING  'ACROSS'  OR  'OVER'  THE  ROWS, 
SINCE  ROWS  ARE  THE  FIRST  OF  TWO  DIMENSIONS  OF  A  MATRIX, 

THIS  MEANS  THAT  THE  SYMBOL  a  WORKS  'OVER'  THE  FIRST  DIMENSION, 
TO  REVERSE  OVER  THE  LAST  DIMENSION  (E,G,  COLUMNS  OF  A  MATRIX), 

USE  THE  SYMBOL  <$  (ALT  5),  IN  PLACE  OF  8, 

THIS  IS  IMPORTANT  WHEN  WORKING  WITH  HIGHER -DI MENS I  ON AL  ARRAYS, 

FOR  EXAMPLE,  IN  A  THREE-DIMENSIONAL  ARRAY  OF  PAGES,  ROWS,  AND 
COLUMNS,  *  WILL  REVERSE  OVER  THE  COLUMNS,  g  OVER  THE  PAGES, 

TO  REVERSE  OVER  ANY  DIMENSION,  YOU  MAY  SPECIFY  THE  DIMENSION  IN 
BRACKETS  FOLLOWING  THE  a  (OR  THE  $)  SYMBOL, 

FOR  EXAMPLE,  TO  REVERSE  OVER  THE  ROWS  OF  A  THREE-DIMENSIONAL  ARRAY 
CALLED  AA,  ENTER  8C23AA  OR  *£23AA.  T0  REVERSE  OVER  THE  PAGES, 
ENTER  eAA  OR  t£13AA.  TO  REVERSE  OVER  THE  COLUMNS,  ENTER  ftAA 

or  e£33AA. 
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ROTATE 


ROT 


.  $  . 

THE  SYMBOL  4 )  (ALT  5)  13  USED  FOR  THE  DYADIC  ROTATE  FUNCTION, 

THE  RIGHT  ARGUMEHT  CAH  BE  CHARACTER  OR  HUMERIC,  OF  ANY  RAHK, 

THE  LEFT  ARGUMEHT  MUST  BE  AH  INTEGER  SCALAR  OR  ARRAY, 

IT  RETURNS  ALL  THE  ELEMENTS  OF  THE  RIGHT  ARGUMEHT  IH  THE  SAME  SHARE, 
BUT  IH  A  DIFFERENT  ORDER,  AS  FOLLOWS, 

USING  0  WITH  TWO  SCALAR  ARGUMENTS  SIMPLY  RETURNS  THE  RIGHT  ARGUMEHT, 

A  VECTOR  RIGHT  ARGUMENT  REQUIRES  A  SCALAR  LEFT  ARGUMEHT, 

EACH  ELEMENT  CF  THE  RIGHT  ARGUMEHT  IS  MOVED  TO  THE  LEFT  BY  THE  HUMBER 
OF  PLACES  INDICATED  IN  THE  LEFT  ARGUMEHT, 

FOR  EXAMPLE*  2*2  3  5  ->  5  2  3  3®  'ROTATE'  =>  ATEROT 

WHEN  USED  WITH  A  MATRIX,  $  TAKES  EITHER  A  SCALAR  LEFT  ARGUMEHT  OR  A 
VECTOR  WITH  AS  MANY  ELEMENTS  AS  THERE  ARE  ROWS  III  THE  MATRIX, 

:-pH  TAKES  THE  COLUMNS  AS  UNITS  AND  MOVES  EACH  COLUMN  TO  THE  LEFT  Bt 
THE  NUMBER  OF  SPACES  INDICATED  BY  THE  SCALAR, 

for  example;  if  m  =>  123  then  2®*  =>  312 

4  5  6  6  4  5 

7  3  9  9  7  3 

V®M  TAKES  EACH  ROW  INDIVIDUALLY  AND  MOVES  THE  ELEMENTS  "0  THE  LEFT  BY 
THE  NUMBER  OF  SPACES  INDICATED  BY  THE  CORRESPONDING  ELEMEHT  OF  THE 
LEFT  ARGUMENT,  FOR  EXAMPLE* 

2  3  1®M  =)  312  THE  FIRST  ROW  IS  MOVED  2  SPACES  LEFT 

45£  THE  SECOND  ROW  IS  ROTATED  3  SPACES 

397  THE  THIRD  ROW  IS  ROTATED  ONCE 

EACH  ELEMENT  IS  IN  THE  SAME  ROW  BUT  A  DIFFERENT  COLUMN,  SO  APL 

USERS  REFER  TO  THIS  AS  WORKING  'ACROSS1  OR  'OVER'  THE  COLUMNS, 
SINCE  COLUMNS  ARE  THE  SECOND  OF  TWO  DIMENSIONS  OF  A  MATRIX, 

THIS  MEANS  THAT  THE  SYMBOL  ®  WORKS  'OVER'  THE  LAST  DIMENSION, 

TO  ROTATE  OVER  THE  FIRST  DIMENSION  (E,G,  ROWS  OF  A  MATRIX),  USE  THE 
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SYMBOL  a  (ALT  7),  I  SI  PLACE  OF  <J) 


THIS  IS  IMPORTANT  WHEN  WORKING  WITH  HIGHER- DIMENSIONAL  ARRAYS, 

FOR  EXAMPLE,  IN  A  THREE-DIMENSIONAL  ARRAY  OF  PAGES,  ROWS,  AMD 
COLUMNS,  $  WILL  ROTATE  OVER  THE  COLUMNS,  9  OVER  THE  PAGES, 

TO  ROT  A”E  OVER  ANY  DIMENSION,  YOU  MAY  SPECIFY  THE  DIMENSION  IN 
BRACKETS  FOLLOWING  THE  $  (OR  THE  9)  SYMBOL, 

THE  LEFT  ARGUMENT  MUST  HAVE  THE  SAME  SHAPE  AS  THE  RIGHT  ARGUMENT 

OMITTING  THE  DIMENSION  BEING  ROTATED  OVER,  OR  IT  MAY  BE  A  SCALAR, 
FOF  E ' ;  A  M  P  L  f*  ,  TO  ROTATE  OVER  THE  ROWS  OF  A  THREE-DIMENSIONAL  ARRAY 
CALLED  AA  WHERE  f  A  A  =>  2  3  4»  ENTER  EITHER  S$[21aA  DF  2Jaa 
WHERE  fW  ,-r  >  £  4.  T0  ROTATE  OVER  THE  PAGES,  ENTER  S©A  A  OR  M©  AA 
OR  OR  M$C1]AA  WHERE  fM  =>  3  4,  TO  ROTATE  OVER  THE 

COLUMNS,  ENTER  SJAA  OR  MiJjAfi  OR  5e[3]AA  OF:  M©[3]AA  WHERE  fn  =>  2  3. 
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204 


ROTATE 


ROT  1 


. . . .  a  . . . . 

THE  SYMBOL  9  (ALT  J)  rS  USED  FOR  THE  DYADIC  ROTATE  FUNCTION, 

THE  RIGHT  ARGUMENT  CAM  BE  CHARACTER:  OR  NUMERIC,  OF  ANY  RANK, 

THE  LEFT  ARGUMENT  MUST  BE  All  INTEGER  SCALAR  OR  ARRAY, 

IT  RETURNS  ALL  THE  ELEMENTS  OF  THE  RIGHT  ARGUMENT  IN  THE  SAME  SHAPE, 
BUT  IN  A  DIFFERENT  ORDER,  AS  FOLLOWS, 

USING  9  WITH  TWO  SCALAR  ARGUMENTS  SIMFLr  RETURNS  THE  RIGHT  ARGUMENT, 

A  VECTOR  RIGHT  ARGUMENT  REQUIRES  A  SCALAR  LEFT  ARGUMENT, 

EACH  ELEMENT  OF  THE  RIGHT  ARGUMENT  IS  MOVED  TO  THE  LEFT  BY  THE  NUMBER 
OF  PLACES  INDICATED  IN  THE  LEFT  ARGUMENT, 

for  example:  2e2  35  =>  523  39’ rotate1  Sj  aterot 

WHEN  USED  WITH  A  MATRIX,  9  TAKES  EITHER  A  SCALAR  LEFT  ARGUMENT  OR  A 
VECTOR  WITH  AS  MANY  ELEMENTS  AS  THERE  ARE  COLUMNS  IN  THE  MATRIX, 

S9M  TAKES  TI-'E  ROWS  AS  UNITS  AND  MOVES  EACH  ROW  UP  BY  THE  NUMBER 
SPACES  INDICATED  BY  THE  SCALAR, 

for  example*,  if  m  =>  12  3  them  2s*  =>  7  3  9 

4  5  6  1  2  3 

7  9  9  4  5  6 

V$M  TAKES  EACH  COLUMN  INDIVIDUALLY  AMD  MOVES  THE  ELEMENTS  UP  BY 

THE  HUMBER  OF  SPACES  INDICATED  BY  THE  CORRESPONDING  ELEMENT  OF  THE 
LEFT  ARGUMENT,  FOR  EXAMPLE* 


2  3  19* 

=  >  7 

2  6 

THE 

FIRST 

COLUMN  IS  MOVED  2 

SPACES  UP 

1 

5  9 

THE 

SECOND  COLUMN  IS  ROTATED 

3  SPACES 

4 

8  3 

THE 

THIRD 

COLUMN  IS  ROTATED 

ONCE 

EACH  ELEMENT  IS  IN  THE  SAME  COLUMN  BUT  A  DIFFERENT  ROW,  SO  ARL 
USERS  REFER  TO  THIS  AS  WORKING  'ACROSS*  OR  'OVER*  THE  ROWS, 

SINCE  ROWS  ARE  THE  FIRST  OF  TWO  DIMENSIONS  OF  A  MATRIX, 

THIS  MEANS  THAT  THE  SYMBOL  9  WORKS  'OVER*  THE  FIRST  DIMENSION, 

TO  ROTATE  OVER  THE  LAST  DIMENSION  (E.G,  COLUMNS  OF  A  MATRIX),  USE  THE 
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Sl'HBOL  9  (ALT  5),  IN  PLACE  OF  a 


THIS  IS  IMPORTANT  WHEN  WORKING  WITH  HIGHER-DIMENSIONAL.  ARRAYS, 

FOR  EXAMPLE,  IN  A  THREE-DIMENSIONAL  ARRAY  OF  PAGES,  ROWS,  AND 
COLUMNS,  >  WILL  ROTATE  OVER  THE  COLUMNS,  a  OVER  THE  PAGES, 

TO  ROTATE  OVER  ANY  DIMENSION,  YOU  MAY  SPECIFY  THE  DIMENSION  IN 
BRACKETS  FOLLOWING  THE  a  (OR  THE  SYMBOL, 

THE  LEFT  ARGUMENT  MUST  HAVE  THE  SAME  SHAPE  AS  THE  RIGHT  ARGUMENT 

OMITTING  THE  DIMENSION  BEING  ROTATED  OVER,  OR  IT  MAY  BE  A  SCALAR, 
FOR  EXAMPLE,  TO  ROTATE  OVER  THE  ROWS  OF  A  THREE-DIMENSIONAL  ARRAY 
CALLED  AA  WHERE  ffiA  =,  T  3  4»  ENTER  EITHER  S®[2]ftA  OR 
WHERE  fM  =  >  2  4.  T0  ROTATE  OVER  THE  PAGES,  ENTER  SfiAA  OR  Me AA 
OR  S<J)Q]AA  OR  M$njAA  WHERE  f M  =>  3  4,  TO  ROTATE  OVER  THE 
COLUMNS,  ENTER  S$AA  OR  M$A  A  OR  Sa[3]AA  OR  MeC3]fift  WHERE  fM  =>  2  3. 
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205 


TRANSPOSE -MONADIC 


TRAM 


. . . . .  a  . 

THE  SYMBOL  5  (ALT  £  )  IS  USES  FOB;  THE  MONADIC  TRANSPOSE  FUHCTIO II, 
IT  TAKES  NUMERIC  OF:  CHARACTER  ARGUMENTS  OF  AH  I  RANK, 

IT  RETURNS  ALL  THE  ELEMENTS  OF  THE  ARGUMENT  IN  A  DIFFERENT  SHARE 
AND  ORDER,  AS  FOLLOWS, 


USING  %  WITH  A  SCALAR  OR  VECTOR  SIMPLY  RETURNS  THE  ARGUMENT, 

WHEN  USED  WITH  A  MATRIX,  $  PERFORMS  MATRIX  TRANSPOSITION; 

THE  ROWS  BECOME  COLUMNS  AND  THE  COLUMNS  BECOME  ROWS, 

FOR  EXAMPLE,  IF  M  =)  12  3  THEN  5jM  =>  14  7 

4  5  6  2  5  8 

7  3  9  3  6  9 

WHEN  USED  WITH  HI GH ER -DIMENS  I OHAL  ARRAYS,  TRANSPOSE  REVERSES  THE 
ORDER  OF  THE  DIMENSIONS, 

FOR  EXAMPLE,  IN  A  THREE-DIMENSIONAL  ARRAY  OF  RAGES,  ROWS,  AND 
COLUMNS,  THE  RAGES  WILL  BECOME  ROWS  AND  THE  ROWS  PAGES, 

THAT  IS,  THE  ELEMENT  IN  THE  FIRST  PAGE,  SECOND  ROW,  THIRD  COLUMN 
WILu  BE  TRANSPOSED  TO  THE  THIRD  PAGE,  SECOND  ROW,  FIRST  COLUMN, 

IF  A  F:  FAY  [  1  j  2  J  3  i  4  2  =>  7  THEN  ( *ARRAY ) [4 } 3; 2 *13  =>  7 

THE  SHAPE  OF  THE  RESULT  WILL  ALWAYS  BE  THE  REVERSE  OF  THE  SHARE  OF 
THE  ARGUMENT,  IF  f ARRAY  =>327  THEN  fSARRAY  _>  723 
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206 


TRANSPOSE-DYADIC 


TRAD 


. . .  $  . 

THE  SYMBOL  $  (ALT  £ )  IS  USED  FOR.  THE  DYADIC  TRANSPOSE  FUNCTION, 

THE  RIGHT  ARGUMENT  CAN  BE  CHARACTER  OR  NUMERIC,  OF  ANY  RANK, 

THE  LEFT  ARGUMENT  MUST  BE  A  POSITIVE  INTEGER  SCALAR  OR  VECTOR, 

IT  RETURNS  ALL  THE  ELEMENTS  OF  THE  RIGHT  ARGUMENT  IN  A  DIFFERENT 
SHAPE  AND  ORDER,  AS  FOLLOWS, 

USING  $  WITH  A  SCALAR  RIGHT  ARGUMENT  RETURNS  A  'LENGTH  ERROR1  UNLESS 
THE  LEFT  ARGUMENT  IS  AN  EMPTY  VECTOR,  THEN  IT  RETURNS  THE  SCALAR, 

l$v  RETURNS  THE  VECTOR  V,  ANY  OTHER  SCALAR  LEFT  ARGUMENT  USED  WITH 
A  VECTOR  RIGHT  ARGUMENT  PRODUCES  A  'DOMAIN  ERROR',  AH  1  OTHER 
RANK  LEFT  ARGUMENT  RESULTS  IN  A  'LENGTH  ERROR’, 

WITH  A  MATRIX  RIGHT  ARGUMENT,  THE  LEFT  ARGUMENT  MUST  BE  A  VECTOR; 
EITHER  (1  2)  0R  (2  1).  (2  1)SM  PRODUCES  THE  TRANSPOSE  OF  M) 

THE  COLUMNS  (THE  SECOND  DIMENSION)  BECOME  THE  ROW  (THE  FIRST 
DIMENSION),  (1  2;  8)  *  =>  * 

WITH  A  RIGHT  ARGUMENT  OF  RANK  R,  THE  LEFT  ARGUMENT  MUST  CONTAIN  ALL 
THE  INTEGERS  FROM  1  TO  R,  IN  ANY  ORDER, 

TRANSPOSE  WILL  TAKE  THE  DIMENSIONS  OF  THE  RIGHT  ARGUMENT  AND  FUT  THEM 
IN  THE  ORDER  SPECIFIED  BY  THE  LEFT  ARGUMENT, 

FOR  EXAMPLE,  IF  »A  =>234  THEN  (3  1  2)$ft  WILL  PUT  THE  THIRD 

DIMENSION  FIRST  (COLUMNS  BECOME  PAGES),  THE  FIRST  DIMENSION  SECOND 
(PAGES  BECOME  ROWS),  AND  THE  SECOND  DIMENSION  THIRD  (ROWS  BECOME 

CQLUMHS )  ,  SO  f  ( 3  1  2)<9«  =>  4  2  3. 

IH  OTHER  WORDS,  THE  ELEMENT  IH  THE  SECOND  COLUMN,  THIRD  ROW,  FIRST 
PAGE  WILL  BE  TRANSPOSED  TO  THE  SECOND  PAGE,  THIRD  COLUMN,  FIRST 
ROW,  AND  SO  ON,  IF  A[)  3  23  =>  8  THEN  ((3  1  2 )  <»* )  C2  133  =>  8. 
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TAKE 


TAKE 


. .  f  . 

THE  SYMBOL  f  (UPSHIFT  T )  IS  USED  FOR  THE  DYADIC  TAKE  FUNCTION, 

THE  LEFT  ARGUMENT  MUST  BE  AN  INTEGER  SCALAR  OR  VECTOR, 

THE  RIGHT  ARGUMENT  CAN  BE  CHARACTER  OR  NUMERIC,  OF  ANY  RANK, 

TAKE  RETURNS  SELECTED  ELEMENTS  OF  THE  RIGHT  ARGUMENT  AS  FOLLOWS* 

WHEN  THE  RIGHT  ARGUMENT  IS  A  SCALAR,  THE  LEFT  ARGUMENT  CAN  BE  A  SCALAR 
OR  A  VECTOR  OF  ANY  LENGTH, 

THE  RESULT  OF  LfR  HAS  A  SHARE  EXACTLr'  EGUAL  TO  L,  R  WILL  BE  THE  FIRST 
ELEMENT  IF  L  IS  POSITIVE,  AND  THE  LAST  ELEMENT  IF  L  IS  NEGATIVE,  THE 
OTHER  ELEMENTS  WILL  BE  Q  R  IS  NUMERIC,  BLANK  IF  R  IS  CHARACTER, 
for  example;  if 4  =>  4  r-ff4  =  >  i  2t'A'  =>  « 

f 2f‘A'  =  >  2  "4*2  =>0002  f (3  4>tl  =  >  3  4 

IF  THE  RIGHT  ARGUMENT  IS  A  VECTOR,  THE  LEFT  ARGUMENT  MUST  BE  A  SCALAR 
OR  A  ‘RANX  ERROR'  WILL  RESULT, 

SfV  WILL  RETURN  THE  FIRST  S  ELEMENTS  OF  V,  IF  S  IS  POSITIVE,  OR  THE 
LAST  3  ELEMENTS  OF  V,  IF  S  IS  NEGATIVE, 

IF  3  EXCEEDS  THE  LENGTH  OF  V,  THE  RESULT  WILL  BE  PADDED  WITH  Q'S,  OF 
BLANKS,  CN  THE  RIGHT  IF  S  IS  POSITIVE,  ON  THE  LEFT  IF  S  IS  NEGATIVE, 

fop  example;  3f\lQ  =>  123  -3t ■ alphabet '  =>  bet 

Sf'ABC'  =)  ABC  f5t'OBC  =>  5  "4f  23  =>  0023 

WHEN  THE  RIGHT  ARGUMENT  IS  A  MATRIX  OR  HIGHER  LEVEL  ARRAY,  THE  LEFT 
ARGUMENT  MUST  BE  A  VECTOR  WITH  AS  MANY  ELEMENTS  AS  THERE  ARE 
DIMENSIONS  IN  THE  RIGHT  ARGUMENT,  OR  A  'LENGTH  ERROR'  RESULTS, 

FOR  example;  IF  m  =>  9  3  7  “i  2t*  =>65  2  4+*  =>  9970 

6  5  4  6  5  4  0 

THE  FIRST  ELEMENT  OF  THE  VECTOR  DETERMINES  WHICH  ROWS  ARE  TAKEN, 

AND  THE  SECOND  ELEMENT  DETERMINES  WHICH  COLUMNS  ARE  TAKEN, 

THE  RESULT  WILL  BE  PADDED  WITH  O'*  BLANKS  AS  ABOVE, 
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FOR  HIGHER  LEVEL  ARRAYS,  EACH  ELEMENT  OF  THE  LEFT  ARGUMENT  WILL 
TAKE  ELEMENTS  FROM  THE  CORRESPONDING  DIMENSION, 

FOR  EXAMPLE,  IF  fA  =>  £  5  4}  (2  “3  1 )tM  WILL  RETURN  THE  FIRST 
COLUMN  OF  THE  LAST  THREE  ROWS  OF  THE  FIRST  TWO  PAGES, 

THE  RESULT  OF  TAKE  WILL  ALWAYS  HAVE  A  SHAPE  EXACTLY  EQUAL  TO  THE 
ABSOLUTE  VALUE  OF  THE  LEFT  ARGUMENT, 

IF  THERE  IS  A  HERO  (Q)  ANYWHERE  IN  THE  LEFT  ARGUMENT,  THE  ANSWER  WILL 
BE  AH  EMPTY  ARRAY  WITH  THE  APPROPRIATE  SHAPE, 

FOR  example  *  f  2  "3  lfA  =;-2  3  1  ??  0  ?t»  =>  7  0  7 
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212 


DROP 


DP.  OF 


.  4  . . . 

THE  SYMBOL  4,  (UPSHIFT  U)  IS  USED  FOR  THE  DYADIC  DROP  FUHCTIOH, 

THE  LEFT  ARGUMENT  MUST  BE  AH  INTEGER:  SCALAR  OR  VECTOR, 

THE  RIGHT  ARGUMENT  CAN  BE  CHARACTER  OR  NUMERIC,  OF  AMY  RANK, 

DROP  RETURNS  SELECTED  ELEMENTS  OF  THE  RIGHT  ARGUMENT  AS  FOLLOWS* 

WHEN  THE  RIGHT  ARGUMENT  IS  A  SCALAR,  THE  LEFT  ARGUMENT  CAN  BE  A  SCALAR 
OR  A  VECTOF  OF  ANY  LENGTH, 

IF  ALL  ELEMENTS  OF  THE  LEFT  ARGUMENT  EQUAL  Q>  THE  RESULT  OF  L+S  WILL 
BE  AN  ARRAY  CONTAINING  THE  RIGHT  ARGUMENT*,  OTHERWISE  IT  WILL  BE  AH 
EMPTY  ARRAY,  THIS  ARRAY  HAS  AS  MANY  DIMENSIONS  AS  THE  LEFT  ARGUMENT 
HAS  ELEMENTS  AND  EACH  DIMENSION  IS  OF  LENGTH  1, 

FOR  EXAMPLE;  14-4  =>  (EMPTY)  T14-4  =>  1  0*'*'  =>  A 

2  4  642  =>  (EMPTY)  M2  4  6)42  =>111  0  0  G43  =>  3 

IF  THE  RIGHT  ARGUMENT  IS  A  VECTOR,  THE  LEFT  ARGUMENT  MUST  BE  A  SCALAR 
OR  A  1  RANK  ERROR*  WILL  RESULT, 

S*V  WILL  RETURN  V  OMITTING  THE  FIRST  S  ELEMENTS,  IF  S  IS  POSITIVE, 

OR  THE  LAST  S  ELEMENTS,  IF  S  IS  NEGATIVE, 

IF  S  EXCEEDS  THE  LENGTH  OF  V,  THE  RESULT  WILL  BE  AN  EMPTY  VECTOR, 

for  example;  64(10  =>  7  8  9  10  -34  *  alphabet >  =>  alpha 

54'ABC*  =>  (EMPTY)  P54  *  ABC '  =>  Q  0  +  13  =  >  13 

WHEN  THE  RIGHT  ARGUMENT  IS  A  MATRIX  OR  HIGHER  LEVEL  ARRAY,  THE  LEFT 
ARGUMENT  MUST  BE  A  VECTOR  WITH  AS  MANY  ELEMENTS  AS  THERE  ARE 
DIMENSIONS  IN  THE  RIGHT  ARGUMENT,  OR  A  'LENGTH  ERROR*  RESULTS, 

FOR  example;  IF  m  =>  9  3  7  i  "14M  =>65  0  24*  =  >  7 

6  5  4  4 

THE  FIRST  ELEMENT  OF  THE  VECTOR  DETERMINES  WHICH  ROWS  ARE  DROPPED, 

AND  THE  SECOND  ELEMENT  DETERMINES  WHICH  COLUMNS  ARE  DROPPED, 

FOR  HIGHER  LEVEL  ARRAYS,  EACH  ELEMENT  OF  THE  LEFT  ARGUMENT  WILL 


143 


DROP  ELEMENTS  FROM  THE  CORRESPONDING  DIMENSION, 

FOR  EXAMPLE,  IF  fA  =>  6  S  4»  (2  “3  1)4*  WILL  RETURN  THE  LAST 

THREE  COLUMNS  OF  THE  FIRST  TWO  ROWS  OF  THE  LAST  FOUR  PAGES, 

THE  RESULT  OF  DROP  WILL  ALWAYS  HAVE  A  SHARE  EXACTLY  EQUAL  TO  THE 
SHAPE  OF  THE  RIGHT  ARGUMENT  MINUS  THE  ABSOLUTE  VALUE  OF  THE 
LEFT  ARGUMENT,  EXCEPT  AS  FOLLOWS; 

IF  ANY  ELEMENT  OF  THE  LEFT  ARGUMENT  EXCEEDS  THE  LENGTH  OF  THE 

CORRESPONDING  DIMENSION  IN  THE  RIGHT  ARGUMENT,  THE  RESULT  WILL 
BE  AN  EMPTY  A ft R A  f  OF  THE  APPROPRIATE  SHAPE, 

IN  THE  ABOVE  EXAMPLE*  f(2  "3  1)4*  =/  423 

M3  4  5)4*  =>  3  1  0  3  4  54*  =>  (empty) 
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COMPRESS 


COM2 


.  /  . 

THE  SYMBOL  /  IS  USED  FOR  THE  ft  Y  AD I C  COMPRESS  FUNCTION, 

THE  RIGHT  ARGUMENT  CAN  BE  CHARACTER  OR  NUMERIC,  OF  ANY  RANK, 

THE  LEFT  ARGUMENT  MUST  BE  1,0,  OR  A  VECTOR  OF  1'S  AND  O' 5, 

COMPRESS  RETURNS  SELECTED  ELEMENTS  OF  THE  RIGHT  ARGUMENT,  AS  FOLLOWS} 

1/A  WILL  RETURN  THE  FIGHT  ARGUMENT,  WHILE  0/*  RETURNS  AH  EMPTY  ARRAi, 

Vl/VM  WILL  RETURN  THE  ELEMENTS  OF  V2  THAT  CORRESPOND  TO  1'S  IN  VI, 

FOR  EXAMPLE*  101/123  =>  13  110  l/1 HALT'  =>  HAT 

TWO  VECTOR  ARGUMENTS  MUST  HAVE  THE  SAME  NUMBER  OF  ELEMENTS  OR  A 
'LENGTH  ERROR'  WILL  RESULT, 

V/H  TAKES  THE  COLUMNS  AS  UNITS  AND  RETURNS  THE  COLUMNS  IN  M  WHICH 


CORRESPOND 

• 

TO 

THE 

1'S  IN  V,  FOR  example; 

IF  M  ->  1 

n 

3 

THEN  101/M  a>  13 

4 

5 

6 

4  6 

7 

3 

9 

7  ? 

APL  USERS  REFER  TO  THIS  AS  WORKING  'ACROSS'  OR  'OVER'  THE  COLUMNS, 
SINCE  COLUMNS  ARE  THE  SECOND  OF  TWO  DIMENSIONS  OF  A  MATRIX, 

THIS  MEANS  THAT  THE  SYMBOL  /  WORKS  'OVER*  THE  LAST  DIMENSION, 

TO  COMPRESS  OVER  THE  FIRST  DIMENSION  (E.G,  ROWS  OF  A  MATRIX),  USE  THE 
SYMBOL  /  (ALT  /),  IN  PLACE  OF  /, 

THIS  IS  IMPORTANT  WHEN  WORKING  WITH  H I GHER - D I MENS  I OH AL  ARRAYS, 

FOR  EXAMPLE,  IN  A  THPEE -D I  MENS  I  OH AL  ARRAY  OF  PAGES,  ROWS,  AND 
COLUMNS,  /  WILL  COMPRESS  OVER  THE  COLUMNS,  /  OVER  THE  PAGES, 

TO  COMPRESS  OVER  ANY  DIMENSION,  YOU  MAY  SPECIFY  THE  DIMENSION  IN 
BRACKETS  FOLLOWING  THE  /  (OR  THE  /)  SYMBOL, 

THE  LEFT  ARGUMENT  MUST  BE  A  SCALAR,  OP  A  VECTOR  WITH  THE  SAME 
HUMBER  OF  ELEMENTS  AS  THE  DIMENSION  BEING  COMPRESSED  OVER, 

FOR  EXAMPLE,  TO  COMPRESS  OVER  THE  ROWS  OF  A  THREE-DIMENSIONAL  ARRAY 
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called  aa  where  f a a  =>  2  3  4»  enter  s/C23ftA  or  v/[2]*a  OR  s/[2]aa 
OR  V/C2]fl®  WHERE  fV  =;  3,  TO  COMPRESS  OVER  THE  PAGES ,  ENTER 
S/AA  OR  V/AA  OR  S/C13AA  OR  V/£1]AA  WHERE  pV  =>  2.  T°  COMPRESS 
OVER  THE  COLUMNS,  ENTER  S/AA  OR  V/AA  Oft  S/C33ftft  OR  V/[3]  AA 

where  pv  =>  4, 


14& 


THE  SYMBOL  /  (ALT  j  )  IS  USED  FOR  THE  DYADIC  COMPRESS  FUNCTION, 

THE  RIGHT  ARGUMENT  CAN  BE  CHARACTER  OR  NUMERIC,  OF  ANY  RANK, 

THE  LEFT  ARGUMENT  MUST  BE  1,0*  OR  A  VECTOR  OF  I'S  A  HI*  Q‘3, 

COMPRESS  RETURNS  SELECTED  ELEMENTS  OF  THE  RIGHT  ARGUMENT,  AS  FOLLOWS ; 

1/A  WILL  RETURN  THE  RIGHT  ARGUMENT,  WHILE  Q/A  RETURNS  AN  EMFTl  APRAr, 

V1/V2  WILL  RETURN  THE  ELEMENTS  OF  V2  THAT  CORRESPOND  TO  I'S  IN  VI, 
for  example;  i  o  1/1  23  =>  13  110  I/'halt1  =>  hat 

TWO  VECTOR  ARGUMENTS  MUST  HAVE  THE  SAME  NUMBER  OF  ELEMENTS  OR  A 
'LENGTH  ERROR'  WILL  RESULT, 

V/M  TAKES  THE  ROWS  AS  UNITS  AND  RETURNS  THE  ROWS  IN  M  WHICH 
CORRESPOND  TO  THE  I'S  IN  V,  FOR  EXAMPLE; 

IF  M  s>  123  then  1  0  1 r*  =>  123 

4  5  6  7  8  9 

7  3  9 

AFL  USERS  REFER  TO  THIS  AS  WORKING  'ACROSS'  OR  'OVER'  THE  ROWS, 

SINCE  ROWS  ARE  THE  FIRST  OF  TWO  DIMENSIONS  OF  A  MATRIX, 

THIS  MEANS  THAT  THE  SYMBOL  /  WORKS  'OVER'  THE  FIRST  DIMENSION, 

TO  COMPRESS  OVER  THE  LAST  DIMENSION  (E.G,  COLUMNS  OF  A  MATRIX), 

USE  THE  SYMBOL  /  IN  PLACE  OF  /, 

THIS  IS  IMPORTANT  WHEN  WORKING  WITH  H I GHER -D I MENS  I  ON AL  ARRAYS, 

FOR  EXAMPLE,  IN  A  THREE-DIMENSIONAL  ARRAY  OF  PAGES,  ROWS,  AMD 
COLUMNS,  /  WILL  COMPRESS  OVER  THE  COLUMNS,  /  OVER  THE  PAGES, 

TO  COMPRESS  OVER  ANY  DIMENSION,  YOU  MAY  SPECIFY  THE  DIMENSION  IN 
BRACKETS  FOLLOWING  THE  /  (OR  THE  /)  SYMBOL, 

THE  LEFT  ARGUMENT  MUST  BE  A  SCALAR,  OR  A  VECTOR  WITH  THE  SAME 
NUMBER  OF  ELEMENTS  AS  THE  DIMENSION  BEING  COMPRESSED  OVER, 

FOR  EXAMPLE,  TO  COMPRESS  OVER  THE  ROWS  OF  A  THREE-DIMENSIONAL  ARRAY 


CALLS!'  AA  WHERE  ,’AA  =  >  2  3  4  >  EHTER  S/[2]AA  OR  V/[2]AA  OR  S/[2]AA 
OR  V / [ 2  2  A  A  WHERE  (V  =>  3,  TO  COMPRESS  OVER  THE  PAGES,  EHTER 
S/A A  OR  V/AA  OR  S/[1]AA  OR  V/£i]AA  WHERE  f V  =>  2.  T0  COMPRESS 
OVER  THE  COLUMMS,  EHTER  S/AA  OR  V/AA  OR  S/[3]AA  OR  V/[3]  A A 
WHERE  fV  =>  4, 
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215 


EXPAND 


e;:f  i 


.  \  . . . 

THE  SYMBOL  \  (UPSHIFT  /)  IS  USE!'  FOP.  THE  DYADIC  EXPAND  FUNCTION, 

THE  RIGHT  ARGUMENT  CAN  BE  CHARACTER  OR  NUMERIC,  OF  ANY  RANK, 

THE  LEFT  ARGUMENT  MUST  BE  A  VECTOR  OF  I'S  AMD  Q  '  S  , 

IS  NUMERIC,  OR  BLANKS  IF  IT  IS  CHARACTER.,  AS  FOLLOWS; 

EXPAND  RETURNS  THE  RIGHT  ARGUMENT,  ADDING  0‘5  IF  THE  RIGHT  ARGUMENT 
IS  NUMERIC,  OR  BLANKS  IF  IT  IS  CHARACTER,  AS  FOLLOWS; 

V\5  WILL  RETURN  A  VECTOR  CONSISTING  OF  THE  SCALAR  REPEATED  AS  MANY 
TIMES  AS  THERE  ARE  ; 1 S  IN  V, 

FOR  example;  1  o  1\3  =>  33 

IF  THERE  ARE  NO  I'S  IN  V,  V\S  RETURNS  AN  EMPTY  VECTOR, 

V1/V2  WILL  RETURN  THE  ELEMENTS  OF  V2,  WITH  Q 1 5  OR:  BLANKS  INSERTED 
TO  CORRESPOND  TO  THE  Q '  S  IN  VJ.,  FOR  EXAMPLE; 

1  1  0  1\1  2  3  =>  1  2  0  3  1  0  1  0  1  \  1  AP'L  1  =)  A  P  L 

THE  LEFT  ARGUMENT  MUST  CONTAIN  AS  MANY  I'S  AS  THERE  ARE  ELEMENTS 
IN  THE  RIGHT  ARGUMENT  OR  A  'LENGTH  ERROR'  WILL  RESULT, 

V\M  TAKES  THE  COLUMNS  AS  UNITS  AND  RETURNS  THE  A  MATRIX  WITH  COLUMNS 
OF  Q'S  OR:  BLANKS  INSERTED  TO  CORRESPOND  TO  THE  I'S  IN  V, 

IP  M  =>  123  then  1  o  1  0  l\w  =>  10203 

4  5  6  4  0  5  0  6 

789  70309 

APL  USERS  REFER  TO  THIS  AS  WORKING  'ACROSS'  OR  'OVER'  THE  COLUMNS, 
SINCE  COLUMNS  ARE  THE  SECOND  OF  TWO  DIMENSIONS  OF  A  MATRIX, 

THIS  MEANS  THAT  THE  SYMBOL  \  WORKS  'OVER'  THE  LAST  DIMENSION, 

TO  EXPAND  OVER  THE  FIRST  DIMENSION  (E,G,  ROWS  OF  A  MATRIX),  USE  THE 
SYMBOL  i,  (ALT  ,),  IN  PLACE  OF  \, 

THIS  IS  IMPORTANT  WHEH  WORKING  WITH  HIGHER-DIMENSIONAL  ARRAYS, 

FOR  EXAMP  i ,  IN  A  THREE-DIMENSIONAL  ARRAY  OF  PAGES,  ROWS,  AND 
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m 


i 


COLUMNS ,  v  WILL  EXPAND  OVER  THE  COLUMNS,  OVER:  THE  PAGES, 

TO  EXPAND  OVER  ANT  DIMENSION,  YOU  MAT  SPECIFY  THE  DIMENSION  IN 
BRACKETS  FOLLOWING  THE  \  (OR  THE  \)  STMfcOL, 

F  OF  EXAMPLE,  TO  E  XP  AMD  OVER  THE  ROWS  OF  A  THREE-DIMENSIONAL  ARRAY 
CALLED  AA  WHERE  fAA  =>  2  3  4f  ENTER  V\[21Aft  0P:  v\C23ftA 
WHERE  +  /V  «)  j,  TO  ERRAND  OVER  THE  PAGES,  ENTER  VL AA  OR  V\[ijAA 
WHERE  +/V  =  >  O  »  TO  EXPAND  OVER  THE  COLUMNS,  ENTER  V\AA  OR 
V\[3]AA  WHERE  +/V  =>  4 


150 


—  -  -  — 

r 


216 


EXPAND 


E  F  I 


.  \  . 

THE  SYMBOL  ^  (ALT  ,)  IS  USED  FOR  THE  DYADIC  EXPAND  FUNCTION, 

THE  RIGHT  ARGUMENT  CAN  BE  CHARACTER  OR  NUMERIC,  OF  ANT  RANK. 

THE  LEFT  ARGUMENT  MUST  BE  A  VECTOR  OF  I'S  AND  Q'S, 

EXPAND  RETURNS  THE  RIGHT  ARGUMENT,  ADDING  Q 1 S  IF  THE  SIGH’’  ARGUMENT 
IS  NUMERIC,  OR  BLANKS  IF  IT  IS  CHARACTER,  AS  FOLLOWS; 

V\S  WILL  RETURN  A  VECTOR  CONSISTING  OF  THE  SCALAR  REPEATED  AS  MANY 
TIMES  AS  THERE  ARE  I'S  IN  V, 

FOR  EXAMPLE J  1  $  1\3  =  >  33 

IF  THERE  ARE  NO  I'S  IN  V,  vys  RETURNS  AN  EMPTY  VECTOR, 

vl\v2  MILL  RETURN  THE  ELEMENTS  OF  VO,  WITH  O'  3  OR  BLANKS  INSERTED 
TO  CORRESPOND  TO  THE  Q ' 5  IN  VI,  FOR  EXAMPLE; 

1  1  0  1\1  2  3  =>  1  2  0  2  1  0  1  0  1  \  '  AF'L  '  =,  A  P  L 

THE  LEFT  ARGUMENT  MUST  CONTAIN  AS  MANY  I'S  AS  THERE  ARE  ELEMENTS 
IN  THE  RIGHT  ARGUMENT  OR  A  'LENGTH  ERROR1  WILL  RESULT, 

VMM  T  A  !<  E  5  THE  ROWS  AS  UNITS  AND  RETURNS  THE  MATRIX  WITH  ROWS 
OF  Q'S  OR  BLANKS  INSERTED  TO  CORRESPOND  TO  THE  I'S  IN  V, 

IF  M  =>  12  3  then  1  0  1  \  M  =>  12  3 

4  5  6  0  0  0 

4  5  6 

APL  USERS  REFER  TO  THIS  AS  WORKING  'ACROSS'  OR  'OVER'  THE  ROWS, 
SINCE  ROWS  ARE  THE  FIRST  OF  TWO  DIMENSIONS  OF  A  MATRIX, 

THIS  MEANS  THAT  THE  SYMBOL  \  WORKS  'OVER'  THE  FIRST  DIMENSION, 

TO  EXPAND  OVER  THE  LAST  DIMENSION  (E,G,  COLUMNS  OF  A  MATRIX),  USE 
THE  SYMBOL  \  (UPSHIFT  /),  IN  PLACE  OF 

THIS  IS  IMPORTANT  WHEN  WORKING  WITH  HIGHER-DIMENSIONAL  ARRAYS, 

FOR  EXAMPLE,  IN  A  THREE-DIMENSIONAL  ARRAY  OF  PAGES,  ROWS,  AND 
COLUMNS,  \  WILL  EXPAHD  OVER  THE  COLUMNS,  \  OVER  THE  PAGES, 
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I 


to  expand  over  amt  dimension,  you  may  specify  the  dimension  in 
BRACKETS  FOLLOWING  THE  \  (OF:  THE  \)  SYMBOL, 

THE  LEFT  ARGUMENT  MUST  BE  A  VECTOR  WITH  THE  SAME  HUMBER  OF  1'S  AS 
THERE  ARE  ELEMENTS  III  THE  DIMENSION  BEING  EXPANDED  OVER, 

FOR  EXAMPLE,  TO  EXPAND  OVER  THE  ROWS  OF  A  THREE-DIMENSIONAL  ARRAY 
CALLED  AA  WHERE  fAA  =>  2  3  4 1  ENTER  Vi-[2]AA  OR  V\[2}AA 
WHERE  +/V  =>  3,  TO  EXPAND  OVER  THE  PAGES,  ENTER  V  V A  A  OR  V\[1]AA 
WHERE  +/V  =>  2.  T0  EXPAND  OVER  THE  COLUMNS,  ENTER  V\AA  OR 
V \ Y  3  j  A  A  WHERE  +/v  =>  4 
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21? 


LAMINATE 


LAMI 


THE  S  Y  MB0L  ,  FOLLOWED  BY  AH  HUMBER  IN  BRACKETS  IS  USEB  FOR  THE 

DYADIC  LAMINATE  FUNCTION,  AH  EXTENSION  C'F  THE  CATENATE  FUNCTION, 
THIS  FUNCTION  MILL  COMBIHE  TWO  CHARACTER  OR  NUMERIC  ARGUMENTS 
OF  ANY  RANK  (EXCEPT  TWO  SCALARS)  INTO  A  SINGLE  ARRAY, 

VECTORS  CAM  BE  EXTENDED  BY  LAMINATING  SjQlJV  OR  V,[i]S  OR  V,Q]V. 

THE  HUMBER  IN  THE  BRACKETS  MUST  BE  1  BECAUSE  VECTOR  HAVE  ONLY 
ONE  DIMENSION,  THI5  WORKS  EXACTLY  LIKE  CATENATE, 

NOW  FOR  SOMETHING  REALLY  TRICKY; 

TO  MAKE  A  TWO-ROW  MATRIX  OUT  OF  TWO  VECTORS  OF  THE  SAME  LENGTH, 
ENTER  V1»C.53v2,  ANY  INDEX  BETWEEN  0  AND  •  WILL  DO. 

THIS  CREATES  A  NEW  DIMENSION  PRECEDING  THE  FIRST  DIMENSION  OF 
THE  ARGUMENTS,  THE  OTHER.  DIMENSION  STAYS  THE  SAME  LENGTH, 

TO  MAKE  A  TWO  — COLUMN  MATRIX,  ENTER  VJ,  £1,5^2  (ANY  INDEX  FROM  1  TO  2). 
NOW  THE  NEW  DIMENSION  COMES  AFTER  THE  FIRST,  WHICH  IS  THE  SAME  AS 
THE  LENGTH  OF  THE  ARGUMENTS, 


LAMINATING  A  SCALAR  TO  A  MATRIX  WILL  RESULT  IN  A  MATRIX  WITH  ONE 
MORE  ROW  (IF  THE  INDEX  NUMBER  III  BRACKETS  IS  1)  OR  ONE  MORE 
COLUMN  (IF  the  INDEX  NUMBER  IS  2)  THAN  THE  ORIGINAL  MATRIX, 

ALL  ENTRIES  IN  T HIS  ROW  OR  COLUMN  WILL  HAVE  THE  VALUE  OF  THE  SCALAR, 


IF  M  =)  1 

2  THEN 

SfClDM  =>  5 

5  ahc  *,[235  => 

1 

5 

3 

4 

1 

n 

tm 

3 

4 

5 

3 

4 

LAMINATING  TWO  MATRIXES  WILL  RESULT  IN  A  MATRIX  CONTAINING  THE  TWO 

ORIGINAL  MATRIXES  SIDE  BY  SIDE  (INDEX  2)  VERTICALLY  (INDEX  1), 

for  example;  if  mi  s)  i  2  ahd  *2  =>  5  6 

3  4  7  8 

THEM  mi,C23*2  =>  1256  ***  *2»C13*1  =>  1  2 
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3  4  7  8 


3  4 
5  6 


TO  STACK  THE  MATRIXES  BY  CREATING  A  THIRD  DIMENSION,  ENTER 

*1»[.53M2  (*»'»'  INDEX  BETWEEN  0  «MD  1),  10U  CAM  ALSO  CREATE 

A  THIRD  DIMENSION  BY  Ml, [1.53*2  oft  Ml»[2.53*2.  TRY  IT. 

VARIATIONS  ON  THIS  ThEME  ARE  ALMOST  ENDLESS — EXPERIMENT; 

IN  EVERY  CASE,  THE  NUMBER  IN  THE  BRACKETS  REFERS  TO  THE  DIMENSION 
WHERE  THE  1  SEAM !  IS  —  THE  DIMENSION  THAT  INCREASES  IN  LENGTH. 

IF  THIS  IS  A  NEW  DIMENSION,  IT  WILL  ALWAYS  BE  LENGTH  2  IN  THE  RESULT, 
THE  OTHER  DIMENSIONS  MUST  BE  THE  SAME  LENGTH  IN  BOTH  ARGUMENTS 
(UNLESS  ONE  IS  A  SCALAR)  OR  A  'LENGTH  ERROR'  WILL  RESULT, 
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231 


MATRIX  INVERSE 


MATI 


. . .  B  . . . 

THE  SYMBOL  Q  (ALT  x)  IS  USED  FOR  THE  MONADIC  MATRIX  INVERSE  FUNCTION, 
IT  TAKES  A  NUMERIC  SCALAR,  VECTOR,  OR  MATRIX  ARGUMENT,  AND  RETURNS 
THE  LEFT  INVERSE,  IN  TERMS  OF  MATRIX  ALGEBRA,  THIS  IS  THE  MATRIX 
WHICH  PRODUCES  THE  IDENTITY  WHEN  LEFT -MULT  I P L I ED  WITH  THE  ORIGINAL, 

WHEN  USED  WITH  SCALARS,  Q  IS  ECU  I  VALENT  TO 


g  WILL  TREAT  VECTCRS  AS  }*L  MATRIXES,  WILL  RETURN  THE  VECTOR  VI 

SO  THAT  VI  -f ,  X  V  =>  t 

SQUARE  MATRIXES  WILL  BE  INVERTED  NORMALLY. 

FOR  EXAMPLE}  IF  M  =)  [  2  gM  = '  ~2  1 

3  4  1.5  "0.5 


SOME  NON-SQUARE  MATRIXES  MAY  ALSO  BE  INVERTED, 

FOR  EXAMPLE}  IF  MM  =  >  1  4  THEN  0*2  =>  "0.9444  "0.1111  0.7222 

2  5  0.4444  0.1111  "0.2222 


3  6 


IF  M  IS  NOT  INVERTIBLE,  A  'DOMAIN  ERROR.  '  WILL  RESULT, 
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232  MATRIX_DIVIDE  MATD 

. .  a  . 

THE  SYMBOL  0  (ALT  X)  IS  US ED  FOR  THE  DYADIC  MATRIX  DIVIDE  FUNCTION, 
IT  TAKES  ARITHMETIC  AR0UMEHT5  WITH  RAH  K  <  3,  THE  TWO  ARGUMENTS 
MUST  HAVE  THE  SAME  HUMBER  OF  ROWS, 

III  TERMS  OF  MATRIX  ALGEBRA,  IT  LEFT  MULTIPLIES  THE  LEFT  ARGUMENT  BY 
THE  LEFT  INVERSE  OF  THE  RIGHT  ARGUMENT, 

B0A  PRODUCES  THE  SOLUTION  TO  THE  SET  OF  LINEAR  EQUATIONS  AXsB, 

WHEN  USED  WITH  TWO  SCALARS,  0  IS  EQUIVALENT  TO  4-, 

WHEN  USED  WITH  VECTORS,  0  OPERATES  AS  IF  THE  VECTORS  ARE  IXC  Oft  ftxl 
MATRIXES,  WHICHEVER  IS  APPROPRIATE, 
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241  OUTER_PRODUCT  OUTE 


THE  SYMBOLS  ».  (UPSHIFT  J  FOLLOWED  BY  A  PERIOD)  ARE  PLACED  PRECEDING 
A  H Y  DYADIC  FUNCTION  SYMBOL  TO  PRODUCE  THE  CUTER  PRODUCT  FUHCTIOH, 
THE  ARGUMENTS  MAY  BE  NUMERIC  OR  CHARACTER,  IF  THE  DYADIC  SYMBOL 

ACCEPTS  CHARACTER  ARGUMENTS,  THEY  MAY  BE  OF  ANY  RANK  AND  DO  HOT 
HAVE  TO  AGREE  IN  SHAPE, 

THE  OUTER  PRODUCT  RESULTS  IN  THE  DYADIC  SYMBOL  OPERATING  ON  EACH 
ELEMENT  OF  THE  LEFT  ARGUMENT  COMBINED  WITH  EVERY  ELEMENT  OF 
THE  RIGHT  ARGUMENT, 

FOR  example:  i  2  °.x  3  4  5  =>  3  4  5 

6  8  10 

■STOP'  'POST1  =>  0010 

0  0  0  1 
0  10  0 
10  0  0 

OUTER  PRODUCT  (ALSO  CALLED  'JOT  DOT'  BECAUSE  OF  THE  SYMBOLS) 

CAM  BE  EXTENDED  TO  ARRAYS  OF  AMY  DIMENSION  OR  SIZE, 

THE  SHAPE  OF  THE  RESULT  WILL  ALWAYS  BE  EQUAL  TO  THE  SHAPE  OF  THE 
LEFT  ARGUMENT  CATENATED  TO  THE  SHAPE  OF  THE  RIGHT  ARGUMENT, 

FOR  EXAMPLE;  IF  fAl  =>  34  AND  fA2  =>  65 

THEM  fAi„,+A2  =)  3465 
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INNER  PRODUCT 


NNE 


THE  SYMBOL  ,  (PER  I  OK  OF:  'POT')  MAY  BE  PLACED  BETWEEN  ANY  TWO  DlADIC 
FUNCTION  SYMBOLS  TO  CREATE  THE  INNER  PRODUCT  FUNCTION, 

THE  ARGUMENTS  MAY  BE  NUMERIC  OR  CHARACTER,  IF  APPROPRIATE,  OF  ANY 
RANK,  THE  LENGTH  OF  THE  LAST  DIMENSION  OF  THE  LEFT  ARGUMENT 
MUST  BE  THE  SAME  AS  THE  LENGTH  OF  THE  FIRST  DIMENSION  OF  THE 
RIGHT  ARGUMENT, 

INNER  PRODUCT  IS  MOST  COMMONLY  USED  WITH  +  AND  X  TO  FORM  THE 

CONVENTIONAL  DOT  PRODUCT  OR  MATRIX  PRODUCT  OF  MATRIX  ALGEBRA, 

for  example;  if  vi  =y  12  3  v2  =>  4  5  6 

THEN  VI  +  ,  x  V2  =>  ,32 

INNER  PRODUCT  MAY  BE  EXTENDED  TO  HIGHER  LEVEL  ARRAYS  AS  WELL  AS 

MATRIXES,  THE  SHAPE  OF  THE  RESULT  WILL  BE  THE  SAME  AS  THE  SHAPE 
OF  THE  LEFT  ARGUMENT  CATENATED  TO  THE  SHAPE  OF  THE  RIGHT  ARGUMENT, 
OMITTING  THE  MATCHING  DIMENSIONS  (LAST  OH  THE  LEFT,  FIRST  OH 
THE  RIGHT, 

for  example;  if  =>  Z  6  A  ailIf  M2  =>  4  5 

THEN  j>  «1  (12  =>  3  6  5 


301  index_of  imdo 

.  . . . . . . .  \  . . . 

THE  SYMBOL  t  (UPSHIFT  I)  IS  USED  F  OF:  THE  DYADIC  I  NI'EX  OF  FUHCTIOH, 

THE  LEFT  ARGUMENT  MUST  BE  A  VECTOR  AND  THE  RIGHT  ARGUMENT  CAN  BE 
AMY  RANK,  INDEX  OF  CAM  BE  USED  WITH  CHARACTER  OR  NUMERIC  DATA, 

IT  RETURNS  THE  ROSITIOH  IN  THE  LEFT  ARGUMEMT  OF  THE  ELEMENTS  OF  THE 
RIGHT  ARGUMEMT,  THE  SHARE  OF  THE  RESULT  IS  THE  SAME  AS  THE 
SHAPE  OF  THE  RIGHT  ARGUMENT, 

IF  THE  RIGHT  ARGUMEMT  DOES  MOT  OCCUR  IN  THE  LEFT  ARGUMEMT,  THE  RESULT 
WILL  BE  ONE  PLUS  THE  LENGTH  OF  THE  LEFT  ARGUMENT, 


FOR  example; 

4  3  2  H3  =  > 

BECAUSE 

3 

IS  IN  THE  SECOND  POSITION 

1  HELLO '  \  ' P '  =  > 

6 

BECAUSE 

F 

IS  MOT  FOUND 

VjA  CHECKS  EACH  ELEMENT  OF  THE  RIGHT  ARGUMEMT  INDIVIDUALLY, 

for  example;  3579U234S  =>  55152 

IF  YOU  ASSIGN  ALPHABET*.  •  ABCDEFGHI  JKLMHOPC1R  5TUVWXY2  ' 
THEM  ALPHABET^ ' APL ‘  =>  1  1^  12 
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ENCODE 


ENCO 


THE  SYMBOL  T  (UPSHIFT  >•!  )  IS  USE!'  FOR  THE  DYADIC  ENCODE  FUNCTION, 

IT  TAKES  NUMERIC  ARGUMENTS  OF  ANT  RANK  AMD  RETURNS  THE  REPRESENTATION 
OF  THE  RIGHT  ARGUMENT  IN  THE  NUMBER  SYSTEM  SPECIFIED  BY  THE  LEFT 
ARGUMENT , 

THE  ENTRIES  IN  THE  LEFT  ARGUMENT  DEFINE  THE  NUMBER  OF  VALUES  THAT 
CAN  EE  PLACED  IN  THAT  POSITION, 

FOP  EXAMPLE,  IN  THE  BINARY  SYSTEM,  EACH  POSITION  CAN  TAKE  ONE  OF  TWO 
VALUES,  0  OR  1,  THEREFORE,  TO  TRANSLATE  133  INTO  BINARY,  ENTER; 

2222222  2rl33  =>  1  0  0  0  0  1  0  1 

THE  RESULT  WILL  ALWAYS  BE  THE  SAME  SHARE  AS  THE  LEFT  ARGUMENT,  SO  BE 
SURE  THAT  THE  LE-T  ARGUMENT  15  LARGE  ENOUGH  TO  BE  CORRECT, 

FOR  example ;  2  2  2t133  =>  101 

ENCODE  CAN  ALSO  BE  USED  TO  TRANSLATE  TIMES,  GIVEN  TIME  IN  SECONDS, 

enter  (2000  365  24  60  aO)  t  time  to  receive  a  vector  of  years 
(0  TO  1999),  DAYS  (0  TO  364) T  hours  <o  to  23)*  minutes  <o  to  60)* 
AND  SECONDS  ( ■}  TO  60). 

FOR  example ;  2000  365  24  60  60x456701  =>  0  5  6  51  41 
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DECODE 


DECO 


THE  SYMBOL  A  (UPSHIFT  B)  IS  USED  FOP:  THE  DYADIC  DECODE  FUNCTION, 

IT  TAKES  NUMERIC  ARGUMENTS  OF  ANY  RANK  AND  RETURNS  THE  DECIMAL  VALUE 
OF  THE  RIGHT  ARGUMENT  WHICH  IS  WRITTEN  IN  THE  NUMBER  SYSTEM 
SPECIFIED  BY  THE  LEFT  ARGUMENT, 

THE  ENTRIES  IN  THE  LEFT  ARGUMENT  DEFINE  THE  VALUES  CF  EACH  POSITION 
IN  THE  NUMBER  SYSTEM, 

FOR  EXAMPLE,  IN  THE  BINARY  SYSTEM,  EACH  POSITION  CAN  TAKE  ONE  OF  TWO 
VALUES,  0  OR.  1.  THEREFORE,  TO  TRANSLATE  10000101  rROM  BINARY; 
2x10000101  =>  133 

UNLESS  ONE  ARGUMENT  IS  A  SCALAR,  THE  ARGUMENTS  MUST  BE  THE  SAME  SHAPE 
OR  A  'LENGTH  ERROR'  WILL  BE  PRODUCED, 

DECODE  CAN  ALSO  BE  USED  TO  TRANSLATE  TIMES,  GIVEN  TIME  IN  YEARS, 

(0  TO  199?)  I  <0  TO  364)  t  hours  (o  to  23)  >  minutes  (q  to  60) » 

and  seconds  (0  TO  60).  enter  2000  365  24  60  60  x  time  to 
find  THE  TIME  IN  SECONDS, 

FOR  example ;  2000  365  24  60  60  x  0  5  6  51  41  *>  456701 
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THE  SYMBOL  t  (ALT  C)  IS  USED  FOR  THE  MONADIC  EXECUTE  FUNCTION 
IT  TAKES  A  VECTOR  CHARACTER  ARGUMENT  ONLY,  AND  TREATS  IT  AS 
PM  AFL  EXPRESSION, 

for  example;  i'I  +  2'  =>  3 

IF  V  =>  'HELP',  tV  WILL  RUN  THE  HELP  FUNCTION 
HOWEVER,  t  WILL  HOT  EXECUTE  EXPRESSIONS  BEGINNING  WITH  )  OR  v 
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l '  i  F  O 


. . .  .  .  .  . . .  *  . . . . . . . 

THE  SYMBOL  t  (ALT  ])  IS  USE!'  FOB:  THE  DYADIC  FORMAT  FUNCTION, 

THE  RIGHT  ARGUMENT  MUST  BE  NUMERIC,  OF  ANY  RANK,  AND  THE  LEFT 
ARGUMENT  MUST  BE  A  VECTOR  OF  INTEGERS, 

THIS  FUNCTION  CONVERTS  THE  RIGHT  ARGUMENT  TO  CHARACTER  DATA  IN 
A  TABULAR  FORMAT  SPECIFIED  BY  THE  LEFT  ARGUMENT ,  AS  FOLLOWS; 

IF  THE  LEFT  ARGUMENT  IS  A  SCALAR,  THE  RIGHT  ARGUMENT  WILL  BE  WRITTEN 
WITH  THAT  HUMBER  OF  DECIMAL  PLACES, 

for  example;  2y14  =  >  14.00  (remember  this  is  now  character.  data, 

3*15  28.35  0.1475  =>  15.000  28.350  .148 

NOTICE  THAT  THE  COLUMNS  ARE  OF  EQUAL  WIDTH,  SEPARATED  BY  ONE  SFACE, 

IF  THE  LEFT  ARGUMENT  IS  A  VECTOR  OF  LENGTH  TWO,  EACH  COLUMN  IN  THE 
RIGHT  ARGUMENT  WILL  TAKE  UP  THE  HUMBER  OF  SPACES  SPECIFIED  Br  THE 
FIRST  ELEMENT  OF  THE  LEFT  ARGUMENT,  AND  EACH  ENTRY  WILL  HAVE  THE 
NUMBER  OF  DECIMAL  PLACES  SPECIFIED  BY  THE  SECOND  ENTRY  IN  THE 
LEFT  ARGUMENT,  FOR  EXAMPLE; 

IF  M  =  ;  1,2  3  THEM  5  It*  =>  1.2  3.1 

*4  5.55  *4.0  5.5 

THE  COLUMN  ELEMENT  MUST  BE  LARGE  ENOUGH  TO  WRITE  THE  LONGEST  ENTRY, 
INCLUDING  ONE  SPACE  EACH  FOR  A  NEGATIVE  SIGN  OR  DECIMAL  POINT, 

IF  IT  IS  NOT,  A  'LENGTH  ERROR'  WILL  RESULT, 

REMEMBER  TO  ALLOW  FOR  A  BLANK  BETWEEN  COLUMNS •  3  1T1  2  =>  1,02.0 

THE  LEFT  ARGUMENT  MAY  ALSO  BE  A  VECTOR  OF  LENGTH  EQUAL  TO  EXACTLY 
TWICE  THE  HUMBER  OF  COLUMNS  IN  THE  RIGHT  ARGUMENT, 

IN  THIS  CASE,  THE  ENTRIES  IN  THE  LEFT  ARGUMENT  ARE  PAIRED  AND  EACH 
PAIR  GOVERNS  THE  FORMAT  OF  THE  CORRESPONDING  COLUMN,  AS  ABOVE, 

6281  10  0  t  113.524  1  300.24  =>  113.52  1.0  300 

ONE  FINAL  TWIST;  IF  THE  LEFT  ARGUMENT  IS  A  NEGATIVE  SCALAR,  THE 
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RESULT  WILL  BE  WRITTEN  IK  EXPONENTIAL  NOTATION,  WITH  THE  NUMBER 
OF  DECIMAL  PLACES  IN  THE  MANTISSA  EQUAL  TO  ONE  LESS  THAN  THE 
ABSOLUTE  VALUE  OF  THE  LEFT  ARGUMENT, 

FOR  example;  -i+3  200  =>  3^00  2^02 

~3t4 .6167  10.56  400  =>  4.62^00  1.06EQ1  4.00E02 
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FORMAT-MONADIC 


FORM 


. . . .  t  . . . . 

THE  SYMBOL  f  (ALT  ])  15  USED  FOR:  THE  MONADIC  FORMAT  FUNCTION, 

IT  TAKES  A  NUMERIC  OR  CHARACTER.  ARGUMENT  OF  ANY  RANK  AMD  CONVERTS 
IT  TO  CHARACTER  DATA, 

THIS  IS  USEFUL  IN  CATENATING  NUMERIC  VARIABLES  TO  CHARACTER  DATA, 
FOR  EXAMPLE  J  IF  S  =>  3  AND  V  =)  1  GO  TO  LINE  1 

V,5  WILL  PRODUCE  A  'DOMAIN  ERROR1  BUT  V , tS  =>  GO  TO  LINE  3 


D.  MAKING  MODIFICATIONS 


The  variable  HOWMODS  is  included  in  the  TUTOR  work. space 
to  guide  the  advanced  student,  programmer,  or  instructor  who 
wishes  to  expand,  modify,  or  customize  the  TUTOR  functions 
and  variables.  Seme  suggestions  for  improvement  are 
discussed  in  chapter  3.  Any  ideas  for  modification  of  TUTOR 
are  welcomed —  plea se  pass  them  along  to  Professor  R.  R.  Read 
or  the  author  of  this  thesis,  in  care  of  the  Operations 
Analysis  curricular  office. 
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HOWMODS 


THE  FOLLOW  I  MG  ARE  SOME  TIES  ON  MODIFYING  THE  TUTOR  WORKSPACE; 

TO  MODIFY  TEXT  OF  DESCRIPTIVE  VARIABLES; 

XEDIT  THE  VARIABLE  ( CHECK  MAT  FOR  SHORT  NAME) 

BE  SURE  TO  INCLUDE  THE  APPROPRIATE  FIRST  COLUMN  CONTROL  CHARACTERS 
,  FOR  GENERAL  DESCRIPTION 
»  FOP.  SCALAR  DESCRIPTION  AND  EXAMPLES 
V  FOR  VECTOR  DESCRIPTION  AND  EXAMPLES 
n  FOR  MATRIX  DESCRIPTION  AND  EXAMPLES 

*  FOR  HIGHER-LEVEL  ARRAYS  DESCRIPTION  AND  EXAMPLES 

TO  CHANGE  THE  ORDER  OF  LESSONS; 

XEDIT  MAT  TO  ASSIGN  NEW  LESSON  NUMBERS, 

THEN,  TO  REORDER  MAT  ACCORDING  TO  LESSON  NUMBERS,  ENTER;  OF'DERMAT 

TO  WRITE  NEW  LESSONS* 

WRITE  A  NEW  TEXT  VARIABLE,  USING  CONTROL  CHARACTERS  AS  ABOVE, 

XEDIT  MAT  TO  ADD  A  HEW  ROW,  BE  SURE  TO  INCLUDE; 

COL  1-31  LESSON  NUMBER 

COL  28-315  NAME  OF  THE  TEXT  VARIABLE  (LIMIT  4  CHARACTERS) 

COL  35-51;  FULL  NAME  OF  THE  LESSON  (LIMIT  23  CHARACTERS) 

THE  OTHER  COLUMNS  MAY  BE  LEFT  BLANK  AS  T  HE  I  PERTAIN  TO  FUNCTION 
SYMBOLS  ONLY, 

TO  CHAHGE  OR  WRITE  HEW  QUESTIONS  (NOT  DRILL); 

XEDIT  CUES  TO  CHAHGE  OR  ADD  A  QUESTION,  BE  SURE  TO  ENCLOSE  THE 
TEXT  OF  THE  QUESTION,  BUT  NOT  VARIABLES,  IN  QUOTE  MARKS, 

A  CARRIAGE  RETURN  MA  t  BE  INCLUDED  BY  USING  THE  VARIABLE  CR , 
AHSWER  GROUPS  MAY  BE  SEPARATE  VARIABLES  SUCH  AS  AR ,  ft  K , 

XEDIT  SHOW  TO  INCLUDE  NEW  QUESTIONS  IN  ANY  QUESTION  VECTOR  QV , 

BE  SURE  TO  INCLUDE  THE  CORRESPONDING  ANSWER  IN  THE  VECTOR  AV , 
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APPENDIX  C 
SAMPLE  RUH 


This  appendix  contains  a  printout  of  a  session  with  the 
APL  tutor.  student  response  to  questions  is  preceded  by  a 
dot  or  period.  (This  is  a  function  of  the  terminal  and  r.ot 
part  of  the  input.)  Other  student  input  is  generally 
indented  sight  spaces  and  preceded  by  several  blank  lines. 
At  least  one  example  of  each  of  the  various  ways  to  use  the 
TUTOR  is  included.  Also  the  various  types  cf  student 
response  to  questions  and  drills  are  demonstrated. 
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)  LOAD  TUTOR 

save*  li:n:i5  12/14/83 

YOU  Mar  USE  THE  APL  TUTOR  II!  THREE  WATS; 

(1)  enter;  help 

TO  SELECT  THE  SYMBOLS  THAT  YOU  WAHT  INFORMATION  ABOUT, 

(2)  ehter;  teach 

TO  SELECT  THE  SYMBOLS  THAT  YOU  WANT  INFORMATION  AND  DRILL  ON, 

(3)  enter;  menu 

TO  SEE  A  LIST  OF  SYMBOLS  AMD  TOPICS, 

IF  YOU  HAVE  NEVER  USED  THE  APL  TUTOR  BEFORE,  ENTER;  START 

TO  SEE  THESE  INSTRUCTIONS  AGAIN  AT  ANY  TIME,  ENTER;  HOW 


START 

WELCOME  TO  THE  APL  TUTOR, 

THE  PURPOSE  OF  THIS  WORKSPACE  15  TO  INTRODUCE  YOU  TO 

•A  PROGRAMMING  LANGUAGE'  BY  DESCRIBING  THE  FUNCTIONS  OF  THE 
MANY  SPECIAL  APL  SYMBOLS,  AND  BY  OUTLINING  THE  PROCEDURES  FOR 
DESIGNING  YOUR  OWH  FUNCTIONS, 


THE  APL  TUTOR  ASSUMES  YOU  HAVE  HAD  LINEAR  ALGEBRA  AND  TR I G I  NOME TP Y  , 
CALCULUS  IS  HOT  NECESSARY, 

IF  YOU  HAVE  NEVER  HAD  ANY  COMPUTER  PROGRAMMING  BEFORE,  DON'T  WORRY, 
YOU  CAM  START  USING  APL  RIGHT  AWAY,  AS  A  SUPER-SOPHI ST ICATED 
CALCULATOR  WITH  MANY  BUILT-IN  FUNCTIONS, 

IF  YOU  HAVE  STUDIED  OTHER  COMPUTER  PROGRAMMING  LANGUAGES,  RELAX, 
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APL  IS  WOT  LIKE  AW  V  OF  THE  OTHER'  MAJQF  HIGH-LEVEL  LAWGUAGES, 

YOU  CAM  FORGET  ABOUT  I*  AT  A  TYRES,  INFUT/OUTPUT  FORMATTING,  AND 
MANY  OF  THE  OTHER  TEDIOUS  DETAILS  OF  FORTRAN,  RASCAL,  ETC, 

AFTER  YOU  ARE  SUFFICIENTLY  FAMILIAR  WITH  THE  CALCULATOR  *OD£ 

OF  APL,  YOU  CAN  LEARN  TO  DEFINE  YOUR  OWN  FUNCTIONS  WITH  EASE. 

HERE  IS  SOME  BASIC  INFORMATION  YOU  WILL  NEED  TO  KNOW  IN  ORDER  TO 
UNDERSTAND  THE  APL  TUTOR  LESSONS, 

MONADIC  AND  DYADIC  FUNCTIONS 

YOU  ARE  ALREADY  FAMILIAR  WITH  SYMBOLS  WHICH  REPRESENT  ARITHMETIC 

FUNCTIONS,  SUCH  AS  +  OR  +  ,  APL  USES  THESE  SYMBOLS  AND  MAN  I  OTHERS 
TO  REPRESENT  A  VARIETY  OF  FUNCTIONS, 

MANY  FUNCTIONS,  SUCH  AS  +  ,  REQUIRE  TWO  ARGUMENTS,  THAT  IS,  TWO  INPUT 
NUMBERS,  IN  APL,  THESE  ARE  CALLED  DYADIC  FUNCTIONS,  AND  THE  SYMBOL 
IS  PLACED  BETWEEN  THE  ARGUMENTS  f  FOR  EXAMPLE,  3  +  4, 

OTHER  FUNCTIONS,  SUCH  AS  LH  (NATURAL  LOG),  REQUIRE  ONLY  CHE  ARGUMENT, 
THESE  MONADIC  FUNCTION  SYMBOLS  ARE  PLACED  TO  THE  LEFT  OF  THE  DATA 
WHICH  THEY  ARE  TO  OPERATE  ON,  FOR  EXAMPLE,  LH  3  IN  APL  IS  «3, 

DATA  TYPES 

APL  DISTINGUISHES  ONLY  TWO  TYPES  OF  DATA*  NUMERIC  AND  CHARACTER, 

VERY  SIMPLY,  CHARACTER  DATA  ARE  ENCLOSED  IN  QUOTES  (')  WHEN  ENTERED, 
*2'  IS  CHARACTER  DATA}  2  I5  NUMERIC  DATA,  SOME  FUNCTIONS 
WILL  OPERATE  OH  BOTH  TYPES  OF  DATA,  SOME  ONLY  ON  NUMERIC, 

ARRAYS 

THE  GREATEST  STRENGTH  OF  APL  LIES  IN  ITS  ABILITY  TO  TAKE  AH  ENTIRE 
ARRAY  OF  NUMBERS  AS  A  SINGLE  ARGUMENT,  THUS  TWO  MATRIXES  CAN  BE 
ADDED  BY  ENTERING  SIMPLY  A+B ,  WITH  HO  SUBSCRIPTS,  LOOPS,  ETC, 

THIS  MAKES  IT  IMPORTANT  TO  KNOW  THE  RANK  (THE  HUMBER  OF  DIMENSIONS) 

OF  DATA  IN  USE,  A  SINGLE  NUMBER  IS  NORMALLY  A  SCALAR  (RANK  Q ) , 

A  SERIES  OF  NUMBERS  IS  A  VECTOR,  A  ONE-DIMENSIONAL  ARRAY  (RANK  1), 
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NUMBERS  CAM  ALSO  BE  ARRANGED  III  ROWS  AND  COLUMNS,  TO  MAKE  A  £5I£i; 
(RANK  2).  MATRIXES  CAN  BE  'STACKED'  TO  MAKE  UP  THE  PAGES  OF  A 
THREE-DIMENSIONAL  ARRAY,  OFTEN  CALLED  A  BOOK  (RANK  3),  IN  FACT, 
THERE  IS  NO  LIMIT  TO  THE  HUMBER  OF  DIMENSIONS  IN  AN  APL  ARRAY, 

THE  LENGTH  OF  THE  DIMENSIONS  IS  ALSO  EFFECTIVELY  UNLIMITED,  LENGTH 
REFERS  TO  THE  NUMBER  OF  ELEMENTS  IN  A  DIMENSION,  FOR  EXAMPLE, 

THE  NUMBER  OF  ROWS,  LENGTH  MAY  EVEN  BE  0. 

IN  THIS  TUTORIAL,  A  SCALAR  MAY  BE  REFERRED  TO  AS  5,  L,  OR  R, 

A  VECTOR  MAY  BE  CALLED  V,  V},  OR  V2,  WHILE  A  MATRIX  IS  M,  M|,  OF  M2. 
AH  ARRAY,  WHICH  MAY  BE  A  VECTOR,  A  MATRIX,  OR  AH  ARRAY  OF  AN  I  HIGHER 
DIMENSION,  WILL  BE  LABELLED  A,  AJ,  OS  AO. 

EXAMPLES 

WHEN  EXAMPLES  ARE  GIVEN  IN  THE  TEXT  OF  A  FUNCTION  DESCRIPTION,  THE 

SYMBOL  =)  IS  USED  BETWEEN  THE  EXAMPLE  INPUT  AMD  THE  EXAMPLE  OUTPUT, 
FOR  EXAMPLE*  2+5  =>  7 

THIS  SYMBOL  CAN  BE  READ  AS  'PRODUCES'  OR  'RETURNS', 

ERRORS 

YOU  SHOULD  MOT  RECEIVE  ANY  ERROR  MESSAGES  WHILE  USING  APL  TUTOR, 
HOWEVER,  YOU  MAY  SEE  A  PHRASE  LIKE  'VALUE  ERROR'  (WITHOUT  QUOTE 
MARKS)  WHEN  YOU  ARE  EXPECTING  A  NORMAL  RESPONSE, 

OR  IF  YOU  ACCIDENTALLY  HIT  THE  ENTER  KEY  WHEN  THE  CQMFUTER  TS  NOT 
EXPECTING  AN  INPUT,  THE  FUNCTION  MAY  END  ABRUPTLY,  LIKE  THIS; 
menu  C6: 

IF  EITHER  OF  THESE  THINGS  HAPPEN,  BE  SURE  TO  ENTER*  -*  ^ UPSHIFT 

THEN  RESTART  WITH  AH Y  COMMAND, 

HALTING  A  LESSON 

YOU  MAY  STOP  AHY  LESSON  AT  ANY  POINT  WHERE  A  QUESTION  IS  ASKED 
BY  EHTERIHG*  STOP 


TO  SEE  THIS  INFORMATION  AGAIN  AT  ANY  TIME,  ENTER*  BASICS 


you  mat  start  a  lesson  in  three  ways; 

(1)  ENTER}  LESSOH  NEXTLESSON 

TO  START  THE  LESSOH  FOLLWING  THE  LAST  OHE  YOU  COMPLETED, 

(2)  enter;  lesson  nnh  (where  mmh  is  a  3-digit  number  ) 

TO  START  LESSON  NUMBER  NHM , 

TO  SEE  A  LIST  OF  LESSON  NUMBERS,  ENTER;  MENU 

(3)  ENTER;  TEACH 

TO  SELECT  THE  SYMBOL  THAT  YOU  WANT  A  LESSON  OH. 

TO  SEE  THIS  INFORMATION  AGAIN  AT  ANY  TIME,  ENTER;  HOWTEACH 


TO  START  TOUR  FIRST  LESSOH  IN  APL ,  ENTER}  LESSON  101 


LESSON  101 


THE  SYMBOL  ”  (UPSHIFT  2)  Is  USED  ONLY  TO  ENTER  NEGATIVE  NUMBERS, 
IT  CAN  9E  USED  ONL  Y  IN  FRONT  OF  SCALARS  (SINGLE  NUMBERS), 

NOT  VARIABLE  NAMES,  ARITHMETIC  EXPRESSIONS,  OR  ARRAYS, 

TO  CHANGE  ARITHMETIC  SIGN  USE  THE  SYMBOL  -  (UPSHIFT 

HOW  MANY  ARGUMENTS  DOES  THE  NEG  AT  I VE  _NUMBER  FUNCTION  TAKE'’ 

.1 

RIGHT 

WHAT  RANK  CAH  THE  RIGHT  ARGUMENT  OF  NEG A T I VE.HUMBER  BE? 

ENTER  S  FOR  SCALAR 


V  FOR  VECTOR 


f 


X  FOR  MATRIX 
A  FOR  ANY  RAM  K 
.5 

RIGHT 


CAM  MEG AT I VE_MUMBER  TAKE  CHARACTER  ARGUMENTS? 

.M 

RIGHT 

THIS  IS  THE  END  OF  TOUR  LESSON, 

FOR  THE  NEXT  LESSON  IN  SEQUENCE,  ENTER*  LESSON  HEMTLESSOH 
TO  START  ANOTHER  LESSON,  ENTER*  LESSON  NNN 


LE5SOH  MEXTLESSON 


THE  SYMBOL  +  IS  USED  FOR  THE  MONADIC  CONJUGATE  FUNCTION, 

THIS  IS  AN  IDENTITY  FUNCTION  WHICH  RETURNS  ITS  ARGUMENT,  AFTER 
EVALUATION  IF  NECESSARY,  IT  TAKES  NUMERIC  ARGUMENTS  OF  ANY 

HOW  MANY  ARGUMENTS  DOES  THE  CONJUGATE  FUNCTION  TAKE? 

.STOP 

THIS  LESSON  HAS  BEEN  HALTED, 


RANK 


TO  START  ANOTHER  LESSON.  ENTER! 


LESSON  NNN 


LESSO  tl  109 


THE  SYMBOL  r  (UPSHIFT  X)  IS  USED  FOP.  THE  DYADIC  DIVISION  FUNCTION, 
IT  FERFORMS  SIMPLE  DIVISION  OH  MUMEPIC  ARGUMENTS  OF  ANY  RANK, 

HOW  MAHY  ARGUMENTS  POES  THE  PIVIPE  FUNCTION  TAKE"5 
,  TWO 

SORRY,  PLEASE  TRY  AGAIN 

HOW  MANY  ARGUMENTS  POES  THE  PIVIPE  FUNCTION  TAKE? 

.2 

RIGHT 

WHAT  RANK  CAN  THE  LEFT  ARGUMENT  OF  PIVIPE  BE? 

ENTER  S  FOR  SCALAR 

V  FOR  VECTOR 
X  FOR  MATRIX 

A  FOR  ANY  RANK 

.5 

SORRY,  PLEASE  TRY  AGAIN 

WHAT  RANK  CAN  THE  LEFT  ARGUMENT  OF  PIVIPE  BE? 

ENTER  S  FOR  SCALAR 

V  FOR  VECTOR 
X  FOR  MATRIX 

A  FOR  AN?  RANK 

.A 

RIGHT 

WHAT  RANK  CAN  THE  RIGHT  ARGUMENT  OF  PIVIPE  BE? 

ENTER  S  FOR  SCALAR 

V  FOR  VECTOR 
X  FOR  MATRIX 

A  FOR  ANY  RANK 
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SORRY,  FLEASE  TP.'!'  AGAIN 


WHAT  RAIIK  CAH  THE  RIGHT  ARGUMENT  OF  DIVIDE  BE? 
ENTER  S  FOR  SCALAR 

V  FOR  VECTOR 
X  FOR  MATRIX 

A  FOR  AH'!  RANK 
,  V 

SORRY,  PLEASE  TRY  AGAIN 

WHAT  RANK  CAH  THE  RIGHT  ARGUMENT  OF  DIVIDE  BE? 
ENTER  S  FOR  SCALAR 

V  FOR  VECTOR 
X  FOR  MATRIX 

A  FOR  ANY  RANK 


SORRY,  THE  CORRECT  ANSWER  IS  A 

YOU  ENTERED  5  WRONG  ANSWERS  OUT  OF  3  QUESTIONS, 

IF  YOU  WANT  TO  RETAKE  THIS  LESSON,  ENTER;  LESSON  \Q7' 


THIS  LESSON  HAS  BEEN  HALTED, 

TO  START  ANOTHER  LESSON.  ENTER*  LESSON  HUH 


HELP 


ENTER  THE  SYMB0L(5)  YOU  WOULD  LIKE  INFORMATION  ABOUT, 
OF,., FOR  MENU  SELECTION,  ENTER;  MENU 

,  MENU 

INFORMATION  IS  AVAILABLE  OH  THE  FOLLOW  I MG  S I MBOL5/TOF ICS J 


101 

N  E  G  A  T  I  V  £  _  N  U  M  B  E  R 

102 

+ 

CONJUGATE 

103 

+ 

PLUS 

1 04 

- 

CHANGERS I GH 

105 

- 

MINUS 

106 

X 

S I GMUM 

107 

X 

TIMES 

103 

T 

RECIPROCAL 

109 

- 

DIVIDE 

121 

( 

PARENS 

1  n  '■> 

X  *.  «. 

1 

O  U  O  T  E 

123 

SPECIFICATION 

124 

f 

SHAPE 

125 

f 

RESHAPE 

126 

[ 

BRACKETS 

127 

f 

RAVEL 

128 

t 

CATENATE 

129 

INI  e:<_GENERATOR 

131 

1 

/ 

REDUCTION 

132 

i 

REDUCTION 

141 

* 

EXPONENTIAL 

142 

* 

POWER 

143 

• 

natural_log 

144 

t 

LOG  AR I THM 

145 

Q 

F I_TIMES 

146 

0 

GEOMETRIC 

147 

« 

FACTORIAL 

148 

i 

* 

BINOMIAL 

149 

1 

i 

MAGNITUDE 

151 

\ 

SCAN 

152 

V 

SCAN 

161 

r 

CEILING 

162 

1 

FLCOR 

163 

r 

MAXIMUM 

164 

L 

MINIMUM 

165 

1 

RESIDUE 

166 

t 

G  P.  A  D  E  _  U  R 

167 

t- 

GRADE_DOWN 

168 

? 

R:  Cl _ 

169 

? 

DEAL 

180 

= 

ECtUAL 

181 

f 

NOT_EQUAL 

182 

< 

LESS_THAH 

133 

LES5_OR_EGUAL 

184 

l 

GREATER _OR_tGUAL 

135 

> 

G  R  E  A  T  ER:  _  T  H  Ail 

191 

H 

NOT 

192 

A 

AND 

193 

A 

HAND 

194 

•/ 

OP- 

195 

V 

NOS 

196 

l 

MEMBER  OF 

201 

* 

REVERSE 

202 

B 

REVERSE 

203 

u 

ROTATE 

204 

9 

ROTATE 

205 

s 

TRANSPOSE -MONADIC 

206 

* 

TRANSPOSE-DYADIC 

211 

t 

TAKE 

212 

4 

DROP 

213 

/ 

COMPRESS 

214 

/ 

COMPRESS 

215 

\ 

EXPAND 

216 

\ 

EXPAND 

219 

f 

LAMINATE 

231 

a 

MATRIX_IN VERSE 

232 

SI 

MATRIX _DIVIDE 

241 

O 

OUTER_PRODUCT 

242 

* 

IN  1 1 E  R  _  P  R  O  D  U  C  T 

301 

\ 

INDEX_OF 

304 

T 

ENCODE 

305 

X 

DECODE 

306 

i 

EXECUTE 

307 

t 

FORMAT-DYADIC 

308 

t 

FORMAT-MONADIC 

TO  SEE  MENU  AGAIN,  ENTER*,  MENU 

FOR  INFORMATION  ABOUT  FUNCTION,  ENTER;  INFO  HNN  (WHERE  NNN  IS  MENU  N 
UMBER ) 

TO  GO  THROUGH  TUTORIAL  LESSON,  ENTER;  LESSON  NNN 
* 
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LESSON  |07 


. . . . . .  X  . . . 

THE  SYMBOL  X  15  USED  FOP  THE  DYADIC  TIMES  FUNCTION, 

THIS  PERFORMS  SIMPLE  MULTIPLICATION  ON  NUMERIC  ARGUMENTS  OF  AIM  S 

HOW  MANY  ARGUMENTS  DOES  THE  TIMES  FUNCTION  TAKE? 

.2 

RIGHT 

WHAT  RANK  CAN  THE  LEFT  ARGUMENT  OF  TIMES  BE? 

ENTER  S  FOR  SCALAR 

V  FOR  VECTOR 
X  FOR  MATRIX 

A  FOR  ANY  RANK 

• 

SORRY,  THE  CORRECT  ANSWER  IS  A 

WHAT  RANK  CAN  THE  RIGHT  ARGUMENT  OF  TIMES  BE? 

ENTER  S  FOR  SCALAR 

V  FOR  VECTOR 
X  FOR  MATRIX 

A  FOR  ANY  RANK 

.ANY 

RIGHT 

FOR  EXAMPLE;  2X4  =>  8  ORDER  AND  spacing  are  hot  IMPORTANT 

DOES  51x52  EOUAL  52X51? 

RIGHT 

WHAT  IS  THE  RESULT  OF J 

'20  X  80 
.'160 
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I 


SORRY,  CORRECT  ANSWER  IS; 

"1600 

WHAT  IS  THE  RESULT  OF ; 

ao  x  -30 

• "2400 

CORRECT ; 

TO  MULTIFY  EACH  ELEMENT  OF  A  VECTOR  Bi  A  SCALAR,  ENTER  SxV  OR  VxS. 
VJXV2  RESULTS  IN  the  PRODUCT  OF  CORRESPONDING  ELEMENTS  OF  VJ,  AND  >'2, 

FOR  example;  3X1123)  =>36?  (1  2  3)x3  =>  3a? 

( 1  2  3 ) x ( 2  4  6 )  =>  23  18 

IF  VI  AND  V?  ARE  HOT  THE  SAME  LENGTH,  YOU  WILL  GET  A  'LENGTH  ERROR', 

IF  ONE  ARGUMENT  IS  A  VECTOR,  THE  OTHER  ARGUMENT  HA  T  BE  SCALAR  OF  VECTO 
(T/F) 

.T 

RIGHT 

WHAT  IS  THE  RESULT  OF; 

0 . 6  x  0,5  0,9 

.".3  ,54 

SORRY,  CORRECT  ANSWER.  ISJ 

0.3  "0.54 

WHAT  IS  THE  RESULT  OF; 

0.1  X  0.2  0.7 
..2  .7 

SORRY,  CORRECT  ANSWER  ISJ 

0.02  0.07 

WHAT  IS  THE  RESULT  OF; 

"0.2  X  "0.1  0.6 

.".02  ".12 

SORRY,  CORRECT  ANSWER  ISJ 

0.02  “0.12 

PLEASE  REVIEW  THE  DESCRIPTION  OF  THIS  FUNCTION  OR  TALK  WITH  YOUR 


r  ' 

I 


I NSTRUC  TOP:  BEFORE  RETURNING  TO  THIS  UNIT, 

THIS  LESSON  HAS  BEEN  HALTED, 

TO  START  ANOTHER  LESS  Of1  ,  ENTER;  LESSON  MHH 


LESSON  124 


THE  SYMBOL  p  IS  USED  FOR  THE  MONADIC  SHAPE  FUNCTION, 

THIS  RETURNS  A  DESCRIPTION  OF  THE  5ICE  OF  ITS  ARGUMENT,  WHICH  CAN 
BE  NUMERIC  OR  CHARACTER,  OF  ANY  RANK, 

THE  SYMBOL  CAN  BE  USED  TWICE  (ppA)  TO  RETURN  THE  RANK  OF  ITS  ARGUMENT, 

HOW  MANY  ARGUMENTS  DOES  THE  SHAPE  FUNCTION  TAKE? 

.1 

RIGHT 

WHAT  RANK  CAN  THE  RIGHT  ARGUMENT  OF  SHAPE  BE? 

ENTER  S  FOR  SCALAR 
V  FOR  VECTOR 
X  FOR  MATRIX 
A  FOR  ANT  RANK 

.A 

RIGHT 

IF  THE  ARGUMENT  15  A  SCALAR,  fS  RETURNS  HO  NUMBER  (AN  EMPTY  VECTOR), 
BECAUSE  A  SCALAR  HAS  NO  DIMENSION,  ppS  =>  Q 
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r 


ENTERING  pV  RETURNS  OWE  NUN  E'ER  WHICH  REPRESENTS  THE  LENGTH 


THE  VECTOR'S  ONE  DIMENSION,  ffV  =>  1 

WHAT  IS  THE  RESULT  OF J 

f  10  20  90  "40 

<  P  4 

SORRY ,  THIS  ANSWER  NOT  ACCEPTABLE,  PLEASE  ENTER  A  NUMERIC  ANSWER, 

WHAT  IS  THE  RESULT  OF; 

f  10  20  90  ’40 

.4 


correct; 

WHAT  IS  THE  RESULT  OF; 

f  2  0  3 


.3 

CORRECT ; 


THE  SHARE  OF  MATRIXES  IS  EXPRESSED  AS  A  TWO-ELEMENT  VECTOR, 

THE  FIRST  ELEMENT  EOUALS  THE  MUMPER:  OF  ROWS  (THE  LENGTH  OF  THE 
FIRST  DIMENSION),  AND  THE  SECOND  ELEMENT  EOUALS  THE  NUMBER  OF 
COLUMNS  (THE  LENGTH  OF  THE  SECOND  DIMENSION), 

for  example;  if  m  s>  i  2  3  then  pM  =>  2  3  and  p  f  m  =>  2 

4  5  6 


FOR  HIGHER-LEVEL  ARRAYS,  fA  WILL  BE  A  VECTOR  WITH  AS  MANY  ELEMENTS  AS 
A  HAS  DIMENSIONS,  THE  NUMBER  OF  COLUMNS  WILL  ALWAYS  PE  THE  LAS r 
ELEMENT  OF  pA,  THE  NUMBER  OF  ROWS  WILL  ALWAYS  PE  THE  NE.MT-TO-L  AST 
ELEMENT,  PRECEDED  BY  THE  HUMBER  OF  'PAGES'  OR  PLANES,  PRECEDED  Sr 
THE  NUMBER  OF  'BOOKS’  OR  SPACES,  AND  SO  OH, 

FOR  EXAMPLE;  IF  D  IS  A  4-DIMENSIOHAL  ARRAY,  ppB  =>  4, 

IF  fD  =>  5  3  4  2  THEN  D  HAS  5  BOOKS,  EACH  WITH  3  PAGES,  EACH  OF 
WHICH  HAS  4  ROWS  AND  2  COLUMNS,  (THIS  WOULD  BE  DISPLAYED  AS 
FIFTEEN  SUCCESSIVE  4x2  MATRIXES — THE  FIRST  THREE  BEING  THE  FIRST 
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BOOK,  THE  SECOND  THREE  BEING  THE  SECOND  BOOK,  ETC,) 

C  AM  SHAPE  TAKE  CHARACTER  ARGUMENTS? 

.  ' 

RIGHT 

IF  SO,  WHICH  ARGUMENT ( S )  CAN  BE  CHARACTER? 

ENTER  R  FOR  RIGHT, 

L  FOR  LEFT,  OR 
B  FOR  BOTH 

.R 

RIGHT 

THIS  IS  THE  END  OF  TOUR  LESSON, 

FOR  THE  NEXT  LESSON  IN  SEQUENCE,  ENTER*  LESSON  HEHTLESSON 
TO  START  ANOTHER  LESSON,  ENTER J  LESSON  NNH 


LESSON  NEXTLESSON 


. .  f  . 

THE  SYMBOL  f  IS  USED  FOR  THE  DYADIC  RESHAPE  FUNCTION, 

THIS  TAKES  THE  ELEMENTS  OF  THE  RIGHT  ARGUMENT  AND  REARRANGES  THEM 
ACCORDING  TO  THE  SHARE  SPECIFIED  BY  THE  LEFT  ARGUMENT. 

THE  LEFT  ARGUMENT  MUST  BE  AN  INTEGER  SCALAR  OR  A  VECTOR  CF  INTEGER 
ELEMENTS , 

THE  RIGHT  ARGUMENT  CAN  BE  NUMERIC  OR  CHARACTER,  OF  ANY  RANK. 


HOW  MANY  ARGUMENTS  DOES  THE  RESHAPE  FUNCTION  TAKE? 

T 

♦ 

RIGHT 
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WHAT  RANK  CAM  THE  LEFT  ARGUMENT  OF  RESHAPE  PE? 

ENTER  S  FOR  SCALAR. 

V  FOR  VECTOR 
X  FOR  MATRIX 

A  FOR  AMY  RANK 

.V 

RIGHT 

WHAT  RANK  CAM  THE  RIGHT  ARGUMENT  OF  RESHAPE  BET 
ENTER.  S  FOR  SCALAR 

V  FOR  VECTOR 
X  FOR  MATRIX 

A  FOR  ANY  RANK 

RIGHT 

IF  THE  LEFT  ARGUMENT  IS  A  SCALAR,  THE  RESULT  WILL  BE  A  VECTOR  WITH 

LENGTH  EQUAL  TO  THE  SCALAR,  CONSISTING  OF  THE  ELEMENTS  OF  THE  RIGHT 
ARGUMENT,  TAKEN  IN  ORDER  TOR  LEFT  TO  BOTTOM  RIGHT, 

WHEN  THERE  ARE  NOT  ENOUGH  ELEMENTS  IN  THE  RIGHT  ARGUMENT, 

THE  FUNCTION  WILL  START  OVER  AND  TAKE  THE  ELEMENTS  IN  ORDER  AGAIN, 
AS  MAHY  TIMES  AS  NECESSARY  TO  FILL  THE  VECTOR, 

FOR  EXAMPLE*  4 fl  =>  1  1  1  1 

4p ( ' AB 1 )  =>  ABAB 

IF  THERE  ARE  TOO  MAHY  ELEMENTS  ON  THE  RIGHT,  THE  EXTRAS  ARE  OMITTED. 
FOR  EXAMPLE*  2f ( 1  2  3  4)  =>  1  2 

DOES  31fS2  EQUAL 
,  H 

RIGHT 

WHAT  IS  THE  RESULT  OF; 

2  f  0,6 


! 
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.  .6 

SORRY,  CORRECT  ANSWER  IS* 

0  •  6  0 . 6 

WHAT  IS  THE  RESULT  OF  • 

2  /  0,1 

. .1  .1  .1 

SORRY,  CORRECT  ANSWER  IS* 

0.1  0.1 

WHAT  IS  THE  RESULT  OF* 

3  F  0.6 
« . 6  ,6  .6 
correct ; 

IF  THE  LEFT  ARGUMENT  IS  A  VECTOR,  THE  ELEMENTS  INDICATE,  IN  ORDER, 

LENGTH  OF  EACH  DIMENSION  IN  THE  RESULT, 

FOR  EXAMPLE’  2  2fl  2  3  4  =>  12 

3  4 

THIS  IS  ONE  WAY  TO  ENTER  MATRIXES  OR  ARRAYS  OF  HIGHER  DIMENSION, 

IF  OHE  ARGUMENT  IS  A  VECTOR,  THE  OTHER  ARGUMENT  MAY  RE  SCALAR  OR  VECTOR, 

(T/F) 

.T 

RIGHT 

WHAT  IS  THE  RESULT  OF*, 

3  f  0.1  4 
..1  4  .1 
CORRECT  J 

USING  A  MATRIX  OR  HIGHER-LEVEL  ARRAY  AS  THE  LEFT  ARGUMENT  OF  RESHAPE 
WILL  RESULT  IN  A  'RANK  ERROR', 

IF  ONE  ARGUMENT  IS  A  MATRIX,  THE  OTHER  ARGUMENT  MUST  PE  A  SCALAR 
OR  0  MATRIX  OF  THE  SAME  SHARE,  (T/F) 
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f 


F 


RIGHT 

COM  RESHAPE  TAKE  CHARACTER  ARGUMENTS? 

RIGHT 

IF  SO,  WHICH  ARGUMENT (5 )  CAM  RE  CHARACTER? 

ENTER  R  FOR  RIGHT, 

L  FOR  LEFT ,  OR 
*  FOR  BOTH 

.* 

RIGHT 

THIS  IS  THE  END  OF  TOUR  LESSON, 

FOR  THE  H  E  '■!  T  LESSON  IK  SEQUENCE,  ENTER*  LESSON  NEXTLESSON 
TO  START  ANOTHER  LESSON,  ENTER  J  LESSON  HNM 
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TEACH 


ENTER  THE  SYMBOL(S)  YOU  WOULD  LIKE  INFORMATION  ABOUT, 
OR  FOR  MENU  SELECTION,  ENTER*.  MENU 

,+ 


. . . . . ,  +  , 

THE  SYMBOL  +  IS  USED  FOR  THE  MONADIC  CONJUGATE  FUNCTION, 

THIS  IS  AH  IDENTITY  FUNCTION  WHICH  RETURNS  ITS  ARGUMENT,  AFTER 
EVALUATION  IF  NECESSARY,  IT  TAKES  NUMERIC  ARGUMENTS  OF  ANY 

HOW  MANY  ARGUMENTS  DOES  THE  CONJUGATE  FUNCTION  TAKE"? 

.1 

RIGHT 

WHAT  RANK  CAN  THE  RIGHT  ARGUMENT  OF  CONJUGATE  BE? 

ENTER  S  FOR  SCALAR 
V  FOR  VECTOR 
X  FOR  MATRIX 
A  FOR  ANY  RANK 

.» 

RIGHT 

EXAMPLE*  +-2  =>  2  +”3  +  2  =>  "1. 


CAH  CONJUGATE  TAKE  CHARACTER  ARGUMENTS? 

RIGHT 


RANK  , 


THE  SYMBOL  ♦  IS  USED  FOR  THE  DYADIC  PLUS  FUNCTION 


THIS  PERFORMS  SIMPLE  ADDITION  OH  NUMERIC  ARGUMENTS  OF  AMT  RAM-, 

HOW  MANY  ARGUMENTS  DOES  THE  PLUS  FUNCTION  TAKE? 

.2 

RIGHT 

WHAT  RANK  CAN  THE  LEFT  ARGUMENT  OF  PLUS  RE? 

ENTER  S  FOR  scalar 

V  FOR  VECTOR 
X  FOR  MATRIX 

A  FOR  AMT  RANK 

.« 

RIGHT 

WHAT  RANK  CAM  THE  RIGHT  ARGUMENT  OF  PLUS  RE? 

ENTER  S  FOR  SCALAR 

V  FOR  VECTOR 
X  FOR  MATRIX 

A  FOR  ANT  RANK 

.ft 

RIGHT 

FOR  EXAMPLE;  2+2  =>  4  SPACING  IS  HOT  IMPORTANT, 

DOES  S1+S2  EQUAL  52+51? 

RIGHT 

WHAT  IS  THE  RESULT  OF; 

10  ♦  10 

.+ 

SORRT t  THIS  ANSWER  MOT  ACCEPTABLE,  PLEASE  ENTER  A  NUMERIC  ANSWER, 

WHAT  IS  THE  RESULT  OF; 


10  +  10 

.20 

CORRECT ' 


TO  ODD  0  SCALAR  TO  EACH  ELEMENT  OF  A  VECTOR,  ENTER  EITHER  S  +  V  OR  V  + 
V1  +  V2  WILL  ADD  TWO  VECTORS  ELEMENT  Si  ELEMENT,  FOR  ENABLE; 

2+ ( 3  4  5)  =  >  56  7  (3  4  5) +2  =  >  567 

(3  4  5)+(5  67)  =>  8  10  12 

IF  THE  TWO  VECTORS  BEING  ADDED  ARE  HOT  THE  SAME  LENGTH, 

TOU  WILL  GET  A  'LENGTH  ERROR', 

IF  ONE  ARGUMENT  IS  A  VECTOR,  THE  OTHER  ARGUMENT  MAi  BE  SCALAR  OR  VE 
(T/F) 

,T 

RIGHT 

WHAT  IS  THE  RESULT  OF { 

0.2  +  0.9  0.3 

..2  +  .9  .3 

SORRY,  THIS  ANSWER  NOT  ACCEPTABLE,  PLEASE  ENTER  A  NUMERIC  ANSWER, 

WHAT  IS  THE  RESULT  OF J 

0.2  +  0.9  0.3 

.1.1  .5 

CORRECT  J 

WHAT  IS  THE  RESULT  OF; 

•5  4  3  +  “5 

.STOP 

THIS  LESSOH  HAS  BEEN  HALTED, 

THIS  IS  THE  END  OF  SCHEDULED  LESSONS, 

TO  SELECT  MORE  LESSONS,  ENTER;  TEACH 
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TEACH 


ENTER  THE  SYMBOL (S)  YOU  WOULD  LIKE  INFORMATION  ABOUT  , 

OR  FOR  MENU  SELECTION,  ENTER  }  MENU 

.MENU 

INFORMATION  IS  AVAILABLE  OH  THE  FOLLOWING  SYMBOLS/ TOR  ICS } 


101 

NEGATIVEJIUMBER 

102 

+ 

CONJUGATE 

103 

PLUS 

104 

- 

chahge_sign 

105 

- 

MINUS 

106 

X 

S  I  G  M  U  M 

107 

X 

TIMES 

108 

T 

RECIPROCAL 

109 

- 

DIVIDE 

121 

( 

PARE MS 

122 

' 

QUOTE 

123 

P 

SPECIFICATION 

124 

f 

SHAPE 

L25 

f 

RESHAPE 

126 

C 

BRACKETS 

127 

1 

RAVEL 

123 

t 

CATENATE 

129 

i 

I NDEX  _GEH£F  A  T  OR 

131 

/ 

REDUCTION 

132 

t 

REDUCTION 

141 

* 

EXPONENTIAL 

142 

* 

POWER 

143 

• 

N  A  T  U  R  A  L  _  L  G  G 

144 

• 

LOGARITHM 

145 

Q 

PI_TIMES 

146 

3 

GEOMETRIC 

147 

i 

* 

FACTORIAL 

148 

* 

BINOMIAL 

149 

i 

MAGNITUDE 

151 

\ 

SCAM 

152 

\ 

SCAN 

161 

r 

CEILING 

162 

L 

FLOOR 

163 

r 

MAXIMUM 

164 

L 

MINIMUM 

165 

! 

RESIDUE 

166 

6 

GRADE_UF 

167 

9 

GRADE_BOWH 

163 

? 

ROLL 

169 

? 

PEAL 

180 

= 

EQUAL 

181 

* 

NOT_EQLAL 

182 

< 

LESS_THAH 

183 

LESS_OR:_EQUAL 

194 

> 

GREATER  _Oft_EClL’AL 

135 

> 

greater_than 

191 

V 

NOT 

192 

A 

AND 

193 

* 

KAMO 

194 

V 

OR 

195 

V 

NOR 

196 

t 

MEMBER  OF 

201 

V 

REVERSE 

202 

8 

REVERSE 

203 

* 

ROTATE 

204 

9 

ROTATE 

205 

* 

TRANSPOSE-MONADIC 

206 

* 

TRANSPOSE -BY ABIC 

211 

t 

TAKE 

212 

* 

DROP 

213 

/ 

COMPRESS 

214 

/ 

COMPRESS 

215 

\ 

EXPAND 

216 

\ 

EXPAND 

219 

f 

LAMINATE 

231 

a 

matrix_:hverse 

232 

B 

matrix_b:vibe 

241 

Q 

OUTER _PRQBUCT 

242 

♦ 

I MNER_ PRODUCT 

301 

l 

IHDEX_OF 

304 

T 

ENCODE 

305 

DECODE 

306 

t 

EXECUTE 

307 

t 

F0RMAT-B  T AB J  C 

308 

T 

FORMAT-MONADIC 

TO 

SEE  MENU  AGAIN,  ENTER} 

MENU 

FOR 

INFORMATION  ABOUT 

FUNCTION,  ENTER}  INFO 

HUM 

(WHERE  HNN  IS  MENU  N 

UMBER  ) 

TO  GO  THROUGH  TUTORIAL  LESSON,  ENTER}  LEST  ON  Hill! 


LESSON  105 


THE  SYMBOL  -  (UPSHIFT  + )  IS  USED  FOR  THE  DYADIC  MtNUS  FUNCTION, 
IT  PERFORMS  SIMPLE  SUBTRACTION  OH  NUMERIC  ARGUMENTS  OF  flilY  RANK , 

HOW  MAN  T  ARGUMENTS  DOES  THE  MINUS  FUNCTION  TAKE? 
o 

RIGHT 

WHAT  RANK  CAN  THE  LEFT  ARGUMENT  OF  MINUS  BET 
ENTER  S  FOR  SCALAR 

V  FOR  VECTOR 
:<  FOR  M  A  T R I ' 

A  FOR  ANT  RANK 

.ft 

RIGHT 

WHAT  RANK  CAN  THE  RIGHT  ARGUMENT  OF  MINUS  BE? 

ENTER  S  FOR  SCALAR 

V  FOR  VECTOR. 

FOR  MATRIX 

A  FOR  AN  I'  RANK 

.« 

RIGHT 

FOR  example;  5-2  3  ~10-"2  =>  "8 

DOES  S1-S2  EQUAL  S2-51? 

RIGHT 

WHAT  IS  THE  RESULT  OF J 

0.1  -  '0.3 

.  .4 
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CORRECT ; 


TO  SUBTRACT  a  SCALAR  FROM  EACH  ELEMENT  OF  A  VECTOR,  ENTER  V-S , 

TO  SUBTRACT  EACH  ELEMENT  OF  A  VECTOR  FROM  THE  SAME  SCALAR,  ENTER  S->, 
V1-V2  WILL  SUBTRACT  EACH  ELEMENT  OF  V2  FROM  THE  CORRESPONDING 
ELEMENT  OF  VI, 

VI  AND  V2  MUST  BE  THE  SAME  LENGTH  OR  YOU  vILL  GET  A  '  LENGTH  ERROR', 

FOR  example;  (3  4  5) -2  =  >  123  2-12  4  5)  =  >  '1  '2  “3 

(6  7  S ) - < 1  23)  =>  555 

IF  ONE  ARGUMENT  IS  A  VECTOR,  THE  OTHER  ARGUMENT  MAY  E<E  SCALAR  OR  '.'ECTOR 
(T/F) 

,  T 

RIGHT 

WHAT  IS  THE  RESULT  OF; 

0.9  -  0.6  0.5 

..3  .4 

CORRECT  J 

WHAT  IS  THE  RESULT  OF; 

1  2  3  -  '5 

."4  -3  “2 

SORRY,  CORRECT  ANSWER  IS; 

6  7  3 

WHAT  IS  THE  RESULT  OF; 

"0.9  0.4  -  “0.4 
*  .5  .3 

CORRECT ; 

WHAT  IS  THE  RESULT  OF; 

“0.7  0.8  -  *0.3  0.7 
.,1  1.5 

SORRY,  CORRECT  ANSWER  ISJ 


190 


( 


0.1  0.1 

WHAT  IS  THE  RESULT  OF', 

80  "60  50  "SO  -  90  30  "10  "50 

."10  "90  60  "30 

correct; 

ENTER  M-5  TO  SUBTRACT  ’HE  SCALAR  S  FROM  EACH  ELEMENT  OF  THE  MATRI 
ENTER  S-M  TO  BO  THE  OPPOSITE , 

FOR  EXAMPLE}  IF  M  =>  12  THE,')  4-M  =  >  3  2  “NO  M-2  =1  "1  0 

3  4  10  12 

M1-M2  SUBTRACTS  MATRIX  M2  FROM  MATRIX  Ml  ,  ELEMENT  BY  ELEMENT, 

for  example;  if  «l  =>  1  2  A,,D  M2  =>  3  4  then  h2-h;  =>  2  2 

3  4  5  6  2  2 

IF  Ml  ANB  M2  ARE  HOT  THE  SAME  SHAPE,  A  'LENGTH  ERROR'  WILL  RESULT 
TRYING  TO  SUBTRACT  A  VECTOR  FROM  A  MATRIX  OR  VICE-VERSA  WILL 
PRODUCE  A  'RANK  ERROR1, 

IF  ONE  ARGUMENT  IS  A  MATRIX,  THE  OTHER  ARGUMENT  MUST  BE  A  SCALAR 
OR  A  MATRIX  OF  THE  SAME  SHAPE,  (T/F) 

,  T 

RIGHT 

THESE  PRINCIPLES  CAM  BE  EXTENDED  TO  HIGHER  LEVEL  ARRAYS, 

CAM  MINUS  TAKE  CHARACTER  ARGUMENTS'? 

.« 

RIGHT 

WRITE  A  TRUE  STATEMENT  USING 

for  example;  4=2+2 

.2-2=0 

SORRY,  THIS  STATEMENT  IS  NOT  TRUE, 

TRY  AGAIN, 
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JJ 


UNCLASSIFIED 


F/G  5/9 


NL 


WRITE  A  TRUE  STATEMENT  USING  -, 

FOR  EXAMPLE •  4=2+2 

.4=2+2 

YOUR  ANSWER  DOES  NOT  USE  TRY  AGAIN, 

WRITE  A  TRUE  STATEMENT  USING 
FOR  EXAMPLE {  4=2+2 
. (2-2)=4 

DO  YOU  WISH  TO  REVIEW  THE  DESCRIPTION  OF  MINUS? 

ENTER  Y  OR  N, 

,N 

WRITE  A  TRUE  STATEMENT  USING 

for  example;  4=2+2 

.0=2-2 

correct; 

THIS  IS  THE  END  OF  YOUR  LESSON, 

FOR  THE  NEXT  LESSON  IN  SEQUENCE,  ENTER;  LESSON  NEXTLESSON 
TO  START  ANOTHER  LESSOH,  ENTER*  LESSON  NNN 
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HELP 


ENTER  THE  SYMBOL(S)  YOU  WOULD  LIKE  INFORMATION  ABOUT , 
OR,,, FOR  MENU  SELECTION,  ENTER*  MENU 

,\ 


........... .  \  . . . . 

THE  SYMBOL  )  (UPSHIFT  I)  IS  USED  FOR  THE  MOHADIC  INDEX  GENERATING 
FUHCTIOH, 

IT  IS  USED  WITH  A  SINGLE  NON-NEGATIVE  INTEGER  ARGUMENT  (SCALAR,  OR 
VECTOR  OF  LENGTH  1), 

IT  RETURNS  A  VECTOR  OF  INTEGERS,  IN  ORDER,  BEGINNING  WITH  THE  INDEX 
ORIGIN,  AND  ENDING  WITH  THE  ARGUMENT, 

FOR  EXAMPLE*  13  =>  1  2  3  \0  =>  (AN  EMPTY  VECTOR) 

THE  INDEX  ORIGIN  IS  NORMALLY  (BY  DEFAULT)  1, 

USING  l  WITH  A  NON-INTEGER,  NEGATIVE  OR  ARRAY  ARGUMENT  WILL  PRODUCE  A 
•DOMAIN  ERROR', 


. . . . . .  I  . . 

THE  SYMBOL  (  (UPSHIFT  I)  IS  USED  FOR  THE  DYADIC  INDEX  OF  FUNCTION, 

THE  LEFT  ARGUMENT  MUST  BE  A  VECTOR  AND  THE  RIGHT  ARGUMENT  CAM  BE 
AMY  RAHK ,  INDEX  OF  CAN  BE  USED  WITH  CHARACTER  OR  NUMERIC  DATA, 

IT  RETURNS  THE  POSITION  IN  THE  LEFT  ARGUMENT  OF  THE  ELEMENTS  OF  THE 
RIGHT  ARGUMENT,  THE  SHAPE  OF  THE  RESULT  IS  THE  SAME  AS  THE 
SHAPE  OF  THE  RIGHT  ARGUMENT, 

IF  THE  RIGHT  ARGUMENT  DOES  HOT  OCCUR  IN  THE  LEFT  ARGUMENT,  THE  RESULT 
WILL  BE  ONE  PLUS  THE  LENGTH  OF  THE  LEFT  ARGUMENT, 


for  example;  4  3  2  ii3 

*> 

2 

BECAUSE 

3 

IS 

IN  THE  SECOND  POSITION 

•HELLO* ( <P' 

»> 

6 

BECAUSE 

p 

IS 

NOT  FOUND 

MORE? 
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V^A  checks  each  element  of  the  right  argument  individually, 
FOR  example}  3  5  7  9tl  2  3  4  5  *>  55152 

IF  YOU  ASSIGN  ALPHABET^ 'ABCDEFGHI JKLMNOPORSTUVMXYZ ' 
THEN  ALPHABET \ ' APL 1  =  >  1  16  12 


FOR  MORE  HELP,  ENTER* 


HELP 


MEHU 


INFORMATION  IS  AVAILABLE  ON  THE  FOLLOWING  SYMBOLS/TQP ICS ‘ 


101 

NEGATI VE_NUMBEfi 

102 

+ 

CONJUGATE 

103 

+ 

PLUS 

104 

- 

CHANGE_SIGH 

105 

- 

MINUS 

106 

X 

SIGNUM 

107 

X 

TIMES 

108 

T 

RECIPROCAL 

109 

~ 

DIVIDE 

121 

( 

PARENS 

122 

1 

QUOTE 

123 

h 

SPECIFICATION 

124 

t 

SHAPE 

125 

t 

RESHAPE 

126 

i 

BRACKETS 

127 

9 

RAVEL 

128 

9 

CATENATE 

129 

\ 

INDEX_GEHERATOR 

131 

J 

REDUCTION 

132 

+ 

REDUCTION 

141 

X 

EXPONENTIAL 

142 

* 

POWER 

143 

A 

NATURAL.LOG 

144 

• 

LOGARITHM 

145 

0 

PI_TIMES 

146 

S 

GEOMETRIC 

147 

1 

• 

FACTORIAL 

148 

1 

♦ 

BINOMIAL 

149 

1 

MAGNITUDE 

151 

\ 

SCAH 

152 

SCAH 

161 

r 

CEILING 

162 

L 

FLOOR 

163 

r 

MAXIMUM 

164 

L 

MINIMUM 

165 

1 

RESIDUE 

166 

A 

GRADE_UP 

167 

♦ 

GRADE_DOWH 

168 

7 

ROLL 

169 

7 

DEAL 

180 

= 

EQUAL 

181 

* 

NOT_EQUAL 

182 

( 

LESS_THAN 

183 

i 

LE55_0R_E0UAL 

184 

> 

GREATER_OR_EQUAL 

185 

> 

GREATER_THAN 
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M 

HOT 

192 

A 

AND 

193 

A 

HAND 

194 

V 

OR 

195 

V 

NOR 

196 

I 

MEMBER  OF 

201 

• 

REVERSE 

202 

e 

REVERSE 

203 

• 

ROTATE 

204 

e 

ROTATE 

205 

* 

TRANSPOSE-MONADIC 

206 

TRANSPOSE-DYADIC 

211 

♦ 

TAKE 

212 

4 

DROP 

213 

/ 

COMPRESS 

214 

COMPRESS 

215 

\ 

EXPAND 

216 

\ 

EXPAND 

219 

9 

LAMIHATE 

231 

B 

MATR I X_ INVERSE 

232 

1 

MATRIX_DI VIDE 

241 

* 

OUTER _PRO DUCT 

242 

• 

INNER_PRODUCT 

301 

\ 

INDEX_OF 

304 

T 

ENCODE 

305 

J. 

DECODE 

306 

l 

EXECUTE 

307 

t 

FORMAT-DYADIC 

308 

t 

FORMAT-MONADIC 

TO  EEC  MENU  AGAIN,  ENTER {  MENU 

FOR  INFORMATION  ABOUT  FUNCTION,  EHTER {  INFO  MHN  (WHERE  NNN  IS  MENU  M 

UMBER ) 

TO  GO  THROUGH  TUTORIAL  LESSON,  ENTER*  LESSON  NNN 
• 
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4 


i 

4 


INFO  180 


THE  SYMBOL  s  (UPSHIFT  5)  IS  USED  FOR  THE  DYADIC  EQUALS  FUHCTIOH, 

THIS  COMPARES  NUMERIC  OR  CHARACTER  ARGUMENTS  OF  AHY  RANK , 

IT  RETURHS  1  FOR  EACH  ELEMENT  OF  THE  LEFT  ARGUMENT  THAT  IS  IDENTICAL 
TO  THE  CORRESPONDING  ELEMENT  OF  THE  RIGHT  ARGUMENT,  AND  0  FOR 
EACH  ELEMENT  THAT  IS  NOT, 

FOR  EXAMPLE*  2*2  *>  1  2*4  =>  0  'A '«>*•  =>  0 

MORE? 

FOR  MORE  INFORMATION,  ENTER;  IHFO  MNN 
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TEST  211 


WHAT  IS  THE  RESULT  OF  J 

”3  ♦  "30  40  60  '90 

.40  60  '90 

CORRECT* 

TEST  OK 

TEST  203 

WHAT  IS  THE  RESULT  OF* 

"1  4  60  70  '20  “40 

• 

SORRY,  CORRECT  ANSWER  IS* 

'40  60  70  "20 

WHAT  IS  THE  RESULT  OF* 

24  0  "60  "40  “10 

."40  "10  0  "60 

correct; 

TEST  OK 


TEST  152 

WHAT  IS  THE  RESULT  OF* 

r\  7  "6  "1 
.7  7  7 

correct; 

TEST  OK 
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TEST  l66 

WHAT  IS  THE  RESULT  OF* 

4  '0.3  "0.4 

.2  1 

correct; 

WHAT  IS  THE  RESULT  OF* 

4  3  5  "6 

.STOP 

THIS  TEST  HAS  SEEN  HALTED, 


STOP 

IF  YOU  WANT  TO  END  THIS  SESSION,  ENTER*  )SAVE 

WHEH  YOU  SEE  THE  TINE,  DATE,  AND  ‘TUTOR1  MESSAGE,  ENTER •  )OFP 
,)SAV£ 

11542*19  12/14/83  tutor 

,)OFF 

CONNECT3  01*10*27  VIRTCPU*  000502.88  T0TCPU*  000511.11 
CONNECT*  $5.87  TOTCPU*  *1.85  SI0*  *0.41  TOTAL*  *8.13 
MULT  BY  SHIFT  FACTOR*  *1<DAY),  *0.6<EVE)f  =0.3(NIGHTS) 

LOGOFF  AT  11542542  PST  WEDNESDAY  12/14/83 

VM/370  ONLINE 
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